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了 路 


前 


接触 Spring Boot 有 好 几 年 了 , 也 曾 断 断 续 续 出 过 一 些 教程 , 但 是 都 比较 零散 , 所 使 用 的 Spring 
Boot 版 本 比较 老 ， 一 直 希 望 能 够 系统 地 写 一 本 Spring Boot 相关 的 图 书 ， 后 来 终于 下 定 决心 ， 在 工 
作 之 余 加 班 加 点 ， 于 是 有 了 读者 现在 所 看 到 的 这 本 书 。 

传统 的 Spring 项 目 环境 配置 复杂 腔 肿 ， 开 发 者 早已 不 堪 其 苗 ，Spring Boot 带 来 的 全 新 自动 化 
配置 解决 方案 一 出 现 就 受到 了 极 大 的 关注 ， 使 得 Spring Boot 这 两 年 成 为 Java 领域 的 焦点 之 一 。 本 
书 基于 Spring Boot 2.0.4〔 该 版 本 是 作者 写作 本 书 时 Spring Boot 的 最 新 版 本 ) 完成 。 相 对 于 Spring 
Boot 1.5X，Spring Boot 2 带 来 了 许多 新 变化 ， 这 些 在 本 书 的 相关 章节 都 有 体现 。 

本 书 分 为 16 章 ， 从 以 下 方面 向 读者 介绍 Spring Boot: 


第 1 章 Spring Boot 入 门 

第 2 章 Spring Boot 基础 配置 

第 3 章 Spring Boot 整合 视图 层 技 术 
第 4 章 Spring Boot 整合 Web 开发 
第 5 章 Spring Boot 整合 持久 层 技术 
第 6 章 Spring Boot 整合 NoSQL 

第 7 章 构建 RESTful 服务 

第 8 章 开发 者 工具 与 单元 测试 

第 9 章 Spring Boot 缓存 

第 10 章 Spring Boot 安全 管理 

第 11 章 Spring Boot 整合 WebSocket 
第 12 章 消息 服务 

第 13 章 企业 开发 

第 14 章 应 用 监控 

第 15 章 项 目 构建 与 部 署 

第 16 章 微 人 事项 目 实 战 


其 中 ， 第 1~15 章 从 视图 层 技 术 、 持 久 化 技术 、NoSQL、RESTful、 缓 存 、 安 全 、WebSocket、 
消息 服务 以 及 企业 开发 等 各 个 技术 点 对 Spring Boot 进行 介绍 ; 第 16 章 通过 一 个 Spring BoottVue 
搭建 的 前 后 端 分 离 项 目 带领 读者 将 前 面 15 章 所 学 的 技术 点 应 用 到 项 目 中 ， 使 读者 深入 体会 前 后 端 
分 离 带 来 的 好 处 ， 并 学 会 搭建 前 后 端 分 离 的 项 目 架 构 。 





I | Spring Boot+Vue 全 栈 开 发 实战 
读者 定位 


本 书 适合 有 一 定 Java Web 基础 的 开发 者 阅读 ， 零 基础 的 读者 可 以 先 学 习 Java SE 和 Java Web 
基础 ， 再 来 阅读 本 书 。 











代码 下 载 


本 书 示例 源 代码 请 扫描 右边 的 二 维 码 下 载 。 如 果 下 载 有 问题 ， 请 联系 
booksaga@163.com， 邮 件 主题 为 “Spring Boot+Vue 全 栈 开 发 实战 ”。 
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Spring Boot 入 门 


本 章 概要 


e Spring Boot 简介 
@ 开发 第 一 个 Spring Boot 程序 
e Spring Boot 的 简便 创建 方式 


1.1 Spring Boot 简介 


Spring 作为 一 个 轻 量 级 的 容器 , 在 Java EE 开发 中 得 到 了 广泛 的 应 用 , 但 是 Spring 的 配置 烦琐 
爱 肿 ， 在 和 各 种 第 三 方 框架 进行 整合 时 代码 量 都 非常 大 , 并且 整合 的 代码 大 多 是 重复 的 ,为 了 使 开 
发 者 能 够 快速 上 手 Spring， 利 用 Spring 框架 快速 搭建 Java EE 项 目 ，Spring Boot 应 运 而 生 。 

Spring Boot 带 来 了 全 新 的 自动 化 配置 解决 方案 , 使 用 Spring Boot 可 以 快速 创建 基于 Spring 生 
产 级 的 独立 应 用 程序 。Spring Boot 中 对 一 些 常用 的 第 三 方 库 提 供 了 默认 的 自动 化 配置 方案 ， 使 得 
开发 者 只 需要 很 少 的 Spring 配置 就 能 运行 -个 完整 的 Java EE 应 用 。 Spring Boot 项 目 可 以 采用 传 
统 的 方案 打 成 war 包 , 然后 部 署 到 Tomcat 中 运行 。 也 可 以 直接 打 成 可 执行 jar 包 , 这 样 通过 java -jar 
命令 就 可 以 启动 一 个 Spring Boot 项 目 。 总 体 来 说 ，Spring Boot 主要 有 如 下 优势 : 

日 ”提供 一 个 快速 的 Spring 项 目 搭建 渠道 。 

e@ 开 箱 即 用 ， 很 少 的 Spring 配置 就 能 运行 一 个 Java EE 项 目 。 

@ 提供 了 生产 级 的 服务 监控 方案 。 
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日 ”内 谈 服 务 器 ， 可 以 快速 部 署 。 
e@ ”提供 了 一 系列 非 功 能 性 的 通用 配置 。 
e 纯 Java 配置 ,没有 代码 生成 ,也 不 需要 XML 配置 。 


Spring Boot 是 一 个 “年 轻 ”的 项 目 ， 发 展 非常 迅速 ， 特 别 是 在 Spring Boot 2.0 之 后 ,许多 API 
都 有 较 大 的 变化 ， 本 书 的 写作 基于 目前 最 新 的 稳定 版 2.0.4 (本 书写 作 时 的 最 新 版 ) ,因此 需要 Java 
8 或 9 以 及 Spring Framework 5.0.8.RELEASE 或 更 高 版 本 , 同时 ,构建 工具 的 版 本 要 求 为 Maven 3.2+ 
或 Gradle 4。 





1.2 开发 第 一 个 Spring Boot 程序 


Spring Boot 工程 可 以 通过 很 多 方式 来 创建 ， 最 通用 的 方式 莫 过 于 使 用 Maven 了 ， 因 为 大 多 数 
的 IDE 都 支持 Maven。 





1.2.1 创建 Maven 工程 


这 里 不 过 多 说 明 ，Maven 的 介绍 和 安装 只 介绍 三 种 创建 Maven 工程 的 方式 。 
1. 使 用 命令 创建 Maven 工程 
首先 可 以 通过 Maven 命令 创建 一 个 Maven 工程 ， 在 cmd 窗口 中 执行 如 下 命令 : 


mvn archetype:generate -DgroupId=org.sang -DartifactId=chapter01 








-DarchetypeArtifactId =maven-archetype-quickstart -DinteractiveMode=false 

命令 解释 : 

e -DgroupId 组 织 Id (项 目 包 名 )。 

。 -DartifactId ArtifactId (项 目 名 称 或 者 模块 名 称 )。 

ee -DarchetypeArtifactId 项 目 骨架 。 

e -DinteractiveMode 是 否 使 用 交互 模式 。 

使 用 命令 将 项 目 创建 好 之 后 ， 直 接 用 Eclipse 或 者 IntelliJ IDEA 打开 即 可 。 

2. 在 Eclipse 中 创建 Maven 工程 

大 部 分 的 IDE 工具 都 可 以 直接 创建 Maven 工程 。 在 Eclipse 中 创建 Maven 工程 的 步骤 如 下 : 
步骤 014 创建 项 目 时 选择 Maven Project， 如 图 1-1 所 示 。 
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图 1-1 


步 又 024 选中 Use default Workspace location 复 选 框 ， 如 图 1-2 所 示 。 
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New Maven project 
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图 1-2 
步骤 03 4 选择 项 目 骨架 ， 保 持 默认 设置 即 可 ， 如 图 1-3 所 示 。 


国 New Moven projec 


New Maven project 
Select an Mrchetype 


Catalog: Al Catalogs 
Fher: 








| Group td Ariaa ld 


orgapache maven archetypes 
org apache maven archetypes 
orgapache maven archeypes 
orgapache maven archetypes 
org apache maven archetypes 
orgapache mavenarchegpes 
orgapache maven.archetypes 


maven-archeype-archeyype 
maven-srchetype j2ee-simple 
maven-srchelype-plugin 
maven-archetype-plugin-site 
maven-archetype-pordet 
maven-archetype- profies 
maven-archetype-quickstart 





An archetype which contsins a sample Maven project 


回 Show the last version of Archetype only 


» Advanced 


口 Indude snapshot archetypes 


Add Archegpe 








4 | Spring Boot+Vue 全 栈 开发 实战 











步 最 044 输入 项 目 信息 ， 如 图 1-4 所 示 。 

















图 New Maven Project 口 x 
Specify Archetype parameters | 





Group ld: |orgsang 





Artifact ld: | chapterO1 


Version: ©|0.0.1-SNAPSHOT ~ 




















Package: [org.sang.chapterO1 v 
Properties available from archetype: 

| Name Value Add- 
| Remeve 
» Advanced 





图 1-4 
完成 以 上 4 个 步骤 之 后 ， 单 击 Finish 按钮 即 可 完成 项 目 创建 。 
3. 使 用 IntelliJ IDEA 创建 Maven 工程 


IntelliJ IDEA 作为 后 起 之 秀 , 得 到 了 越 来 越 广泛 的 应 用 。 使 用 IntelliJ IDEA 创建 Maven 工程 的 
步骤 如 下 : 


步 又 01 4 创建 项 目 时 选择 Maven， 但 是 不 必 选 择 项 目 骨架 ， 直 接 单 击 Next 按钮 即 可 ， 如 图 
1-5 所 示 。 





国 New projec 





Me Project SDK: | 嘿 18 (ava verson 180 102 
Java Enterprise 

€ JBoss 

鸭 J2ME 

加 couds 

spring 

We Jaa Fx 

党 Andrcid 

:Ineel Porform Plugin 


Spring niializr 


他 Gradle 


OGroow 

DD Grifion 

© armais 

© Application Forge 
satic Web 

Cr rlash 


区 Kotin 
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步 又 02 4 输入 组 织 名 称 、 模 块 名 称 、 项 目 版 本 号 等 信息 ， 如 图 1-6 所 示 。 
园 New Project x 
Groupld | orgsang LJ 
ARaad [chapteroT| ] 
Version | 10-SNAPSHOT m 





Fe ET Loree) ror 


图 1-6 








步骤 034 选择 项 目 位 置 ， 然 后 单 击 Finish 按钮 ， 完 成 项 目 创建 ， 如 图 1-7 所 示 。 


国 New Project 








Project name: | chapterO1| 








Project location: | Di\workspace\book\chapterO1 


上 Mors Settings 





Previous EEZ Cancel Help 
图 1-7 





这 里 一 共 向 读者 介绍 了 三 种 创建 Maven 工程 的 方式 ， 创 建成 功 之 后 ， 接 下 来 添加 项 目 依赖 。 


1.2.2 项目 构建 


1. 添加 依赖 
首先 添加 spring-boot-starter-parent 作为 parent， 代 码 如 下 : 





1 | <parent> 


2 | <groupId>org.springframework.boot</groupId> 
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3 | <artifactId>spring-boot-starter-parent</artifactId> 
4 | <version>2.0.4.RELEASE</version> 
5 | </parent> 


spring-boot-starter-parent 是 一 个 特殊 的 Starter, 提供 了 一 些 Maven 的 默认 配置 , 同时 还 提供 了 
dependency-management， 可 以 使 开发 者 在 引入 其 他 依赖 时 不 必 输 入 版 本 号 , 方便 依赖 管理 。Spring 
Boot 中 提供 的 Starter 非常 多 ， 这 些 Starter 主要 为 第 三 方 库 提供 自动 配置 ， 例 如 要 开发 一 个 Web 
项 目 ， 就 可 以 先 引 入 一 个 Web 的 Starter， 代 码 如 下 : 


<dependencies> 











<dependency> 
<groupId>org.springframework.boot</groupId> 


<artifactId>spring-boot-starter-web</artifactId> 
</dependency> 
</dependencies> 


2. 编写 启动 类 
接 下 来 创建 项 目的 入 口 类 , 在 Maven 工程 的 java 目录 下 创建 项 目的 包 , 包 里 创建 一 个 App 类 ， 
代码 如 下 : 


QEnableAutoConfiguration 
public class App { 
public static void main(String[] args) { 





SpringApplication.run (App.class, args); 


} 





代码 解释 : 

。 @EnableAutoConfiguration 注解 表示 开启 自动 化 配置 。 由 于 项 目 中 添加 了 spring-boot-starter- 
web 依赖 ， 因 此 在 开启 了 自动 化 配置 之 后 会 自动 进行 Spring 和 Spring MVC 的 配置 。 

e 在 Java 项 目的 main 方 法 中 , 通过 SpringApplication 中 的 run 方法 启动 项 目 。 第 一 个 参数 传 入 
App.class， 告 诉 Spring 哪个 是 主要 组 件 。 第 二 个 参数 是 运行 时 输入 的 其 他 参数 。 


接 下 来 创建 一 个 Spring MVC 中 的 控制 器 一 一 HelloController， 代 码 如 下 : 





1 | @RestController 

作 public class HelloController { 

3 @GetMapping ("/hello") 

4 public String hello() { 

9 return "hello spring boot!"; 
6 } 
7 13 





在 控制 器 中 提供 了 一 个 “/hello ”接口 ,此 时 需要 配置 包 扫 描 才能 将 HelloController 注册 到 Spring 
MVC 容器 中 ， 因 此 在 App 类 上 面 再 添加 一 个 注解 @ComponentScan 进行 包 扫 描 ， 代 码 如 下 : 











QEnableAutoConfiguration 


2 @ComponentScan 
public class App { 
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public static void main(String[] args) { 
SpringApplication.run (App.class, args); 
} 


-ao 心 


} 








也 可 以 直接 使 用 组 合 注解 @Spring BootApplication 来 代替 (@EnableAutoConfiguration 和 
@ComponentScan， 代 码 如 下 : 





Q@Spring BootApplication 
public class App { 
public static void main(String[] args) { 
SpringApplication.run (App.class, args); 


和 
本 
3 
4 
5 } 
6 











1.2.3 项目 启动 


启动 项 目 有 三 种 不 同 的 方式 ， 下 面 一 一 介绍 。 

1. 使 用 Maven 命令 启动 

可 以 直接 使 用 mvn 命令 启动 项 目 ， 命 令 如 下 : 

启动 成 功 后 ， 在 浏览 器 地 址 栏 输 入 “http://localhost:8080/hello” 即 可 看 到 运行 结果 ， 如 图 1-8 
所 示 。 


ei localhost8080/hello x 


© GC 合 © localhost:8080/hellc 


hello spring boot! 





图 1-8 
2. 直接 运行 main 方法 
直接 在 IDE 中 运行 App 类 的 main 方法 ， 就 可 以 看 到 项 目 启动 了 ， 如 图 1-9 所 示 。 








spring Boot : 
// 其 他 日 志 
0s.b.Ww.embedded.tomcat.TomcatWebserver : Tomcat started on port(s): 8080 (http) with context path '' 
.org.sang-.App : Started App in 7.876 seconds (JVM running for 9.518) 


(v2.0.3.RELEASE) 











图 1-9 
启动 成 功 后 ， 也 可 以 在 浏览 器 中 直接 访问 /hello 接口 。 
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3. 打包 启动 

当然 ，Spring Boot 应 用 也 可 以 直接 打 成 jar 包 运 行 。 在 生产 环境 中 ， 也 可 以 通过 这 样 的 方式 来 
运行 一 个 Spring Boot 应 用 。 要 将 Spring Boot 打 成 jar 包 运行 , 首先 需要 添加 一 个 plugin 到 pom.xml 
文件 中 ， 代 码 如 下 : 




















1 | <build> 

2 | <plugins> 

3 | <plugin> 

4 <groupId>org.springframework.boot</groupId> 

5 | <artifactId>spring-boot-maven-plugin</artifactId> 
6 |</plugin> 

7 | </plugins> 

8 | </build> 





然后 运行 mvn 命令 进行 打包 ， 代 码 如 下 : 
1 | mvn package 


打包 完成 后 ,在 项 目的 target 目录 下 会 生成 一 个 jar 文件， 通过 java -jar 命令 直接 启动 这 个 jar 
文件 ， 如 图 1-10 所 示 。 














main] 


图 1-10 


关于 打包 启动 的 详细 配置 ， 读 者 可 以 参考 本 书 第 15 章 。 
经 过 1.2.1~1.2.3 小 节 的 操作 之 后 ， 一 个 Spring Boot 项 目 就 构建 好 并 成 功 启动 了 。 


1.3 Spring Boot 的 简便 创建 方式 





上 面 介绍 的 创建 方式 步骤 有 点 多 。 在 实际 项 目 中 ， 读 者 可 结合 具体 的 开发 环境 选择 更 简便 的 
项 目 创建 方式 。 下 面 介绍 三 种 快捷 创建 方式 。 


1.3.1 在 线 创 建 


在 线 创建 是 Spring Boot 官方 提供 的 一 种 创建 方式 ， 在 浏览 器 中 输入 网 址 “https://start.spring.io/” 
可 以 看 到 如 图 1-11 所 示 的 页 面 。 
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SPRING INITIALIZR 





Generate a wpors . With » and Spring Boot :0: 


Project Metadata Dependencies 

Artifact coordinates had Spring Boot Starters and dependencies to your application 
Group Search for dependencies 

rtact Saected Dependences 


Generate Project alt + 





Don't know what to look for? Want more optionsy Switen to me Tul verson 








图 1-11 


在 这 个 页 面 中 ， 可 以 选择 项 目的 构建 工具 是 Maven 还 是 Gradle、 语 言 是 Java 还 是 其 他 、 要 使 
用 的 Spring Boot 版 本 号 、 项 目的 组 织 Id( 包 名 ) 、 模 块 名 称 以 及 项 目的 依赖 。 所 有 这 些 信息 选 好 
或 填 好 后 ， 单 击 Generate Project 按钮 将 生成 的 模板 下 载 到 本 地 ， 解 压 后 用 IDE 打开 即 可 开始 项 目 
的 开发 。 





1.3.2 ”使 用 IntelliJ IDEA 创建 


如 果 读 者 使 用 的 开发 工具 是 IntelliJ IDEA， 那 么 可 以 直接 创建 一 个 Spring Boot 项 目 ， 但 是 注 
意 直接 创建 Spring Boot 项 目 这 个 功能 在 社区 版 的 ntelliJ IDEA 上 是 不 存在 的 。 创 建 方式 如 下 : 
步骤 01 4 创建 项 目 时 选择 Spring Initializr， 如 图 1-12 所 示 。 




























Project SDK: | 了 G 1.8 (java version 1 目 | New,, | 


确 )2ME 


Choose Initializr Service URL 
国 douds 
国 Spring 


Java FX O 〇 Custom: | | ] 


各 Android Make sure your network connection isactive before continuing 


© Default httpsi//startspringio 


Intell) Platform Plugin 


M Maven 
@ Gradle 
@ Groowy 
© Griffon 
© Grails 


© Application Forge 











图 1-12 


步 又 02 4 输入 项 目 基本 信息 ， 如 图 1-13 所 示 。 
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chapter0T-2 














GO1-SNAPSHOT 








chapter01-2 











使 用 Inteli 1DEA 人 建 Spring Boot 项 天 

















图 1-13 
在 这 里 输入 项 目的 基本 信息 ， 包 括 组 织 I4、 模 块 名 称 、 项 目 构建 类 型 、 最 终生 成 包 的 类 型 、 
Java 的 版 本 、 开 发 语言 、 项 目 版 本 号 、 项 目 名 称 、 项 目 描述 以 及 项 目的 包 。 
步骤 03 4 选择 依赖 ， 如 图 1-14 所 示 。 选 择 项 目 所 需要 添加 的 依赖 ， 之 后 Intelli] IDEA 会 自动 
把 选中 的 依赖 添加 到 项 目的 pom.xml 文件 中 。 
步 昧 044 选择 项 目 创建 路 径 ， 如 图 1-15 所 示 。 


园 NewProject x| 
Dopendencies Spring Boot [204 ~ Solected pependencies 
ore rr 

so web x 
[emplete Engines DRest Reposhories 
Po 口 Rest Repositories HAL Browser 
we Drareons 
ee Dweb sevices 
Pe Dersey Gax-Rs) 
Covd Support Pins 
Goud Confg Bier 
oua Discovery Be 
Be Dapache OCF UAX-RS) 
Cowd ciraui Breaker a 
eud Tracing me 
eva Messoging Ms 
Cloud AWS 口 kevdoak 
(oud Contract i 
Ph hond Foundny Ful stace we developrmert with Tomcat ard Spring 
Am NMC 
spring Cloud ccp 人 Buiding a RESTi web sevice 

wo 会 seming Web Content with soring MVC 

bm 从 buiding REST services wih Spring 


人 ui 
Reference doc 








区 re | rep 
图 1-14 
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Praiedt 


: [chapier012 











Prcject location [Doropoce oo haopeeron 2 








图 


no] EEE | cme | | rp | 
1-15 


经 过 上 面 4 个 步骤 之 后 ， 一 个 可 运行 的 Spring Boot 项 目 就 创建 成 功 了 。 本 书后 面 的 项 目 都 将 
采用 这 种 方式 来 创建 。 


1.3.3 使 用 STS 创建 


也 有 开发 者 习惯 使 用 STS 创建 。 在 STS 中 创建 Spring Boot 项 目 也 很 方便 : 首先 右 击 ， 选 择 
New 一 Spring Starter Project, 如 图 1-16 所 示 ; 然后 在 新 页 面 中 配置 Spring Boot 项 目的 基本 信息 ( 配 
置 和 IntelliJ IDEA 的 基本 一 致 ， 不 再 资 述 ) ， 如 图 1-17 所 示 ; 最 后 选择 需要 添加 的 Starter， 选 择 
完成 后 ， 单 击 Finish 按钮 完成 项 目 创 建 ， 如 图 1-18 所 示 。 


EE 





Show In Ak+Shift+W > 


Copy Cirl#C 
Copy Qualified Name 
paste CdV 


Delete Delete 


Import.. 
Export.. 


Refresh F5 






Import Spring Getting Started Content 
Spring Legacy Project 

Java Project 

Static Web Project 

Dynamic Web Project 

Maven Project 

Project.. 


Aspect 
package 

Class 

Interface 

Enum 

Annotation 

JUnit Test Case 
Source Folder 
Java Working Set 





困 | 这 贸 罗 QQQ 员 Q 只 肢 忆 人 鳃 及 区 区 


到 
上 
CN 
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New Spring Starter Project Dependencies © 


Spring Boot Version: 204 





Service URL [httpsi/startspring;o 











Name [frssprngboot 









Use defoult location jependencies 
Daworkspaceafirstspringboot 

? og Pivotal coud Foundry 
ee 六 > ne vsar 


Java Versior B ~ Language: Spring Covd Gcp 





» Templote Engines 
Group orgsang 








Artifact [firstspringboot 








Version [0.01-SNAPSHOT 








口 Rest Reposiories 
口 Rest Reposiories HAL Browser 
口 HATEOAS 
口 web Services 
口 Jersey UAX-RS) 

口 websocket 
口 REsT cecs 
口 veadin 
口 Apache OF UAx-RS) 

Ratpack 
Mobile 
口 keydoak 


Description 。 [Demo project for Spring Boot 











package orgsang 








Working sets 


口 Add prqjedto working sets 


@ cia | es cra 
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本 章 主 要 向 读者 介绍 了 一 个 简单 的 Spring Boot 项 目的 基本 创建 过 程 ， 从 而 让 读者 感受 到 
Spring Boot 的 魅力 。 当 一 个 Spring Boot 项 目 创 建成 功 之 后 ， 几 乎 零 配置 ， 开 发 者 就 可 以 直接 使 用 
Spring 和 Spring MVC 中 的 功能 了 。 第 2 章 将 向 读者 详细 介绍 Spring Boot 的 基础 配置 。 


讨 
媳 


Spring Boot 基础 配置 


不 使 用 spring-boot-starter-parent 
@Spring BootApplication 

定制 banner 

Web 容器 配置 

Properties 配置 

类 型 安全 配置 属性 

YAML 配置 

Profile 


2.1 不 使 用 spring-boot-starter-parent 


从 第 1 章 的 介绍 中 读者 了 解 到 在 向 pom.xml 文件 中 添加 依赖 之 前 需要 先 添加 spring-boot- 
starter-parent。 spring-boot-starter-parent 主要 提供 了 如 下 默认 配置 : 





Java 版 本 默认 使 用 1.8。 

编码 格式 默认 使 用 UTF-8。 

提供 Dependency Management 进行 项 目 依赖 的 版 本 管理 。 
默认 的 资源 过 小 与 插件 配置 。 
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spring-boot-starter-parent 虽然 方便 ， 但 是 读者 在 公司 中 开发 微服 务 项 目 或 者 多 模块 项 目 时 一 般 
需要 使 用 公司 自己 的 parent， 这 个 时 候 如 果 还 想 进行 项 目 依赖 版 本 的 统一 管理 ， 就 需要 使 用 
dependencyManagement 来 实现 了 。 添 加 如 下 代码 到 pom xml 文件 中 : 





<dependencyManagement> 

<dependencies> 

<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-dependencies</artifactId> 
<version>2.0.4.RELEASE</version> 
<type>pom</type> 

<scope>import</scope> 

</dependency> 

10 | </dependencies> 

11 | </dependencyManagement> 


此 时 ， 就 可 以 不 用 继承 spring-boot-starter-parent 了 ， 但 是 Java 的 版 本 、 编 码 的 格式 等 都 需要 
开发 者 手动 配置 。Java 版 本 的 配置 很 简单 ， 添 加 一 个 plugin 即 可 


<plugin> 
<groupId>org.apache.maven.plugins</groupId> 
<artifactId>maven-compiler-plugin</artifactId> 
<version>3.1</version> 

<configuration> 

<source>1.8</source> 

<target>1.8</target> 

</configuration> 

</plugin> 


至 于 编码 格式 ， 如 果 采 用 了 1.3 节 介 绍 的 方式 创建 Spring Boot 项 目 ， 那 么 编码 格式 默认 会 加 
上 ; 如 果 是 通过 普通 Maven 项 目 配置 成 的 Spring Boot 项 目 ， 那 么 在 pom.xml 文件 中 加 入 如 下 配置 
即 可 : 


oo Dp 











onoDp 














<properties> 

<project .build.sourceEncoding>UTF-8</project.build.sourceEncoding> 
<project .reporting.outputEncoding>UTF-8</project. reporting.outputEncoding> 
</properties> 


AODP 





2.2 @Spring BootApplication 


在 前 文 的 介绍 中 ， 读 者 已 经 了 解 到 @Spring BootApplication 注解 是 加 在 项 目的 启动 类 上 的 。 
@Spring BootApplication 实际 上 是 一 个 组 合 注解 ， 定 义 如 下 : 





1 | asSpring BootConfiguration 

2 | @EnableAutoConfiguration 

| @ComponentScan (excludeFilters = { 

4 QFilter (type = FilterType.CUSTOM, classes = TypeExcludeFilter.class), 
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QFilter (type = FilterType.CUSTOM, classes = 
AutoConfigurationExcludeFilter.class) }) 
public Qinterface Spring BootApplication { 
// 略 
} 


这 个 注解 由 三 个 注解 组 成 。 
@ 第 一 个 @Spring BootConfiguration 的 定义 如 下 : 


co -ao 














Q@Configuration 
public @interface Spring BootConfiguration { 


性 wm 


} 





原来 就 是 一 个 @Configuration， 所 以 @Spring BootConfiguration 的 功能 就 是 表明 这 是 一 个 配置 
类 ， 开 发 者 可 以 在 这 个 类 中 配置 Bean。 从 这 个 角度 来 讲 ， 这 个 类 所 扮演 的 角色 有 点 类 似 于 Spring 
中 applicationContext.xml 文件 的 角色 。 

@ 第 二 个 注解 @EnableAutoConfiguration 表示 开启 自动 化 配置 。 Spring Boot 中 的 自动 化 配置 是 
非 侵 入 式 的 ， 在 任意 时 刻 ， 开 发 者 都 可 以 使 用 自 定义 配置 代替 自动 化 配置 中 的 某 一 个 配置 。 

@ 第 三 个 注解 @ComponentScan 完成 包 扫描 ， 也 是 Spring 中 的 功能 。 由 于 @ComponentScan 注 
解 默认 扫描 的 类 都 位 于 当前 类 所 在 包 的 下 面 ， 因 此 建议 在 实际 项 目 开发 中 把 项 目 启动 类 放 在 根 包 
中 ， 如 图 2-1 所 示 。 


src 


main 
Ml java 
" org 
sang 

controller 
mapper 
model 
service 


隐 Chapter012Application 


resources 








[mn 


图 2-1 


虽然 项 目的 启动 类 也 包含 @Configuration 注解 , 但 是 开发 者 可 以 创建 一 个 新 的 类 专门 用 来 配置 
Bean， 这 样 便于 配置 的 管理 。 这 个 类 只 需要 加 上 @Configuration 注解 即 可 ， 代 码 如 下 : 
1 | @Configuration 


2 | public class MyConfig { 
3 |} 





项 目 启动 类 中 的 @ComponentScan 注解 ， 除 了 扫描 @Service、@Repository、@Component、 
@Controller 和 @RestController 等 之 外 ， 也 会 扫描 @Configuration 注解 的 类 。 
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2.3 定制 banner 


Spring Boot 项 目 在 启动 时 会 打印 一 个 banner， 如 图 2-2 所 示 。 





图 2-2 


这 个 banner 是 可 以 定制 的 ， 在 resources 目录 下 创建 一 个 banner.txt 文件 ， 在 这 个 文件 中 写 入 
的 文本 将 在 项 目 启动 时 打印 出 来 。 如 果 想 将 TXT 文本 设置 成 艺术 字体 ， 有 以 下 几 个 在 线 网 站 可 供 
参考 : 


® http://www.network-science.de/ascii/ 





® http://www.kammerl.de/ascii/AscliSignature.php 
® http://patork.com/software/taag 


以 第 一 个 网 站 为 例 ， 打 开 后 输入 要 设置 的 文本 ， 单 击 “do it! ”按钮 ， 将 生成 的 文本 复制 到 
banner.txt 文件 中 ， 如 图 2-3 所 示 。 
ASell Generat 


[ Logfiles ] 


“| Reflection; no 
Adjustment: eh 了 
Stretch: no 
~ Width; so 





图 2-3 


复制 完成 后 再 启动 项 目 ， 就 可 以 看 到 banner 发 生 了 变化 ， 如 图 2-4 所 示 。 
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j| 本 ,ET \_| / | -| 1 
aM bl Le sb al 
I 2 | 
| | 六 1 人 -| i=l 

V Vv Vv V 
2018-07-04 16:12:18.755 INF0 8968 一 【 aain] org. sang.Chapter012Application 
2018-07-04 16:12:18.761 INF0 8968 一 【 main] org,. sang.Chapter012Application 





图 2-4 


想 关闭 banner 也 是 可 以 的 ， 修 改 项 目 启动 类 的 main 方法 ， 代 码 如 下 : 





public static void main(String[] args) { 

SpringApplicationBuilder builder = new 
SpringApplicationBuilder (Chapter012Application.class); 
builder .bannerMode (Banner .Mode .OFF) .run (args); 


} 


wo wm 





通过 SpringApplicationBuilder 来 设置 bannerMode 为 OFF， 这 样 启动 时 banner 就 消失 了 。 


2.4 Web 容器 配置 


2.4.1 Tomcat 配置 


1. 常规 配置 

在 Spring Boot 项 目 中 ， 可 以 内 置 Tomcat、Jetty、Undertow、Netty 等 容器 。 当 开发 者 添加 了 
spring-boot-starter-web 依赖 之 后 ， 默 认 会 使 用 Tomcat 作为 Web 容器 。 如 果 需 要 对 Tomcat 做 进 一 
步 的 配置 ， 可 以 在 application.properties 中 进行 配置 ， 代 码 如 下 : 


server.port=8081 
server .error.path=/error 





server.servlet .session.timeout=30m 
server.servlet .context-path=/chapter02 
server.tomcat .uri-encoding=utf-8 
server.tomcat .max-threads=500 


aow 必 wm 


SerVer.tomcat .basedir=/home/sang/tmp 
代码 解释 : 
e@ serverport 配置 了 Web 容器 的 端口 号 。 
e errorpath 配置 了 当 项 目 出 错时 跳 转 去 的 页 面 。 
日 session timeout 配置 了 session 失效 时 间 ，30m 表示 30 分 钟 ， 如 果 不 写 单位 ， 默 认 单位 是 秒 。 
由 于 Tomcat 中 配置 session 过 期 时 间 以 分 钟 为 单位 ， 因 此 这 里 单位 如 果 是 秒 的 话 ， 该 时 间 会 
被 转换 为 一 个 不 超过 所 配置 秒 数 的 最 大 分 钟 数 ， 例 如 这 里 配置 了 119， 默 认 单 位 为 秒 ， 则 实 
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际 session 过 期 时 间 为 1 分 钟 。 

econtext-path 表示 项 目 名 称 ， 不 配置 时 默认 为 /。 如 果 配 置 了 ， 就 要 在 访问 路 径 中 加 上 配置 的 路 
径 。 

e@ ni-encoding 表示 配置 Tomcat 请 求 编码 。 

ee Imax-threads 表示 Tomcat 最 大 线程 数 。 

@ basedir 是 一 个 存放 Tomcat 运行 日 志和 临时 文件 的 目录 ， 若 不 配置 ， 则 默认 使 用 系统 的 临时 
目录 。 


当然 ，Web 容器 相关 的 配置 不 止 这 些 ， 这 里 只 列 出 了 一 些 常 用 的 配置 ， 完 整 的 配置 可 以 参考 
官方 文档 Appendix A. Common application properties 一 节 。 


2. HTTPS 配置 


由 于 HTTPS 具有 良好 的 安全 性 ， 在 开发 中 得 到 了 越 来 越 广泛 的 应 用 ， 像 微 信 公众 号 、 小 程序 
等 的 开发 都 要 使 用 HTTPS 来 完成 。 对 于 个 人 开发 者 而 言 ， 一 个 HTTPS 证 书 的 价格 还 是 有 点 贵 ， 
国内 有 一 些 云 服 务 器 厂商 提供 免费 的 HTTPS 证 书 ， 一 个 账号 可 以 申请 数 个 。 不 过 在 jdk 中 提供 了 
一 个 Java 数字 证 书 管理 工具 keytool, 在 \jdk\bin 目录 下 , 通过 这 个 工具 可 以 自己 生成 一 个 数字 证 书 ， 
生成 命令 如 下 : 

命令 解释 : 
-genkey 表示 要 创建 一 个 新 的 密 钥 。 
-alias 表示 keystore 的 别名 。 
-keyalg 表示 使 用 的 加 密 算法 是 RSA， 一 种 非 对 称 加 密 算法 。 
-keysize 表示 密 钥 的 长 度 。 
-keystore 表示 生成 的 密 钥 存放 位 置 。 
-validity 表示 密 钥 的 有 效 时 间 ， 单 位 为 天 。 


在 cmd 窗口 中 直接 执行 如 上 命令 ， 在 执行 的 过 程 中 需要 输入 密 钥 口令 等 信息 ， 根 据 提示 输入 
即 可 。 命 令 执行 完成 后 ， 会 在 当前 用 户 目录 下 生成 一 个 名 为 sang.p12 的 文件 ， 将 这 个 文件 复制 到 
项 目的 根 目录 下 ， 然 后 在 application.properties 中 做 如 下 配置 : 





SerVer.551.key-store=sang.p12 
2 | server.ssl.key-alias=tomcathttps 
server.ssl.key-store-password=123456 





代码 解释 : 

@ ”key-store 表示 密 钥 文件 名 。 

@ ”key-alias 表示 密 钥 别名 。 

日 ”key-store-password 就 是 在 cmd 命令 执行 过 程 中 输入 的 密码 。 

配置 成 功 后 ， 启 动 项 目 ， 在 浏览 器 中 输入 “https://localhost:8081/chapter02/hello” 来 查看 结果 。 
注意 ， 证 书 是 自己 生成 的 ， 不 被 浏览 器 认可 ， 此 时 添加 信任 或 者 继续 前 进 即 可 ， 如 图 2-5 所 示 。 
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用 和 网 站 。 隐私 权 政 笑 


3。 出现 此 问题 的 





图 2-5 
成 功 运行 的 结果 如 图 2-6 所 示 。 


7 DD https://localhost:8081/ x & 





€ CG 全 | A 不 安全 | https://localhost:8081/chapter02/hello 


hello https! 





图 2-6 
此 时 ， 如 果 以 HITP 的 方式 访问 接口 ， 就 会 访问 失败 ， 如 图 2-7 所 示 。 


/ @ localhost:8081/chapte = 


€ GC 全 | © localhost:8081/chapter02/hello 


Bad Request 
This combination of host and port requires TLS. 








图 2-7 


这 是 因为 Spring Boot 不 支持 同时 在 配置 中 启动 HTTP 和 HITPS。 这 个 时 候 可 以 配置 请 求 寻 
向 ， 将 HTTP 请 求 重 定向 为 HTTPS 请 求 。 配 置 方式 如 下 : 
@Configuration 


public class TomcatConfig { 
QBean 








眶 
ay 





TomcatServletWebServerFactory tomcatServletWebServerFactory() { 
TomcatServletWebServerFactory factory = new TomcatServletWebServerFactory(){ 
QOverride 
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可 protected void postProcessContext (Context context) { 

8 SecurityConstraint constraint = new SecurityConstraint (); 
constraint.setUserConstraint ("CONFIDENTIAL"); 

10 SecurityCollection collection = new SecurityCollection(); 

11 collection.addPattern("/*"); 

2 constraint.addCollection (collection); 

13 context .addConstraint (constraint); 

14 } 

15 }; 

16 factory.addAdditionalTomcatConnectors (createTomcatConnector ()); 

17 return factory; 

18 } 

19 private Connector createTomcatConnector() { 

20 Connector connector = new 

21 | Connector ("org.apache.coyote.httpl1]1 .Httpl1lNioProtocol"); 

22 connector.setScheme ("http"); 

23 connector.setPort (8080); 

24 connector.setSecure (false); 

25 connector.setRedirectPort (8081); 

26 return connector; 











这 里 首先 配置 一 个 TomcatServletWebServerFactory， 然 后 添加 一 个 Tomcat 中 的 Connector ( 监 
听 8080 端口 ) ， 并 将 请 求 转发 到 8081 上 去 。 

配置 完成 后 ， 在 浏览 器 中 输入 “http://localhost:8080/chapter02/hello ”， 就 会 自动 重 定向 到 
https://localhost:8081/chapter02/hello 上 。 


2.4.2 ”Jetty 配置 


除了 Tomcat 外 ， 也 可 以 在 Spring Boot 中 嵌入 Jetty， 配 置 方式 如 下 : 





<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 
<exclusions> 

<exclusion> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-tomcat</artifactId> 
</exclusion> 


加 品 Dammmwm 


</exclusions> 


10 | </dependency> 
11 | <dependency> 
12 | <groupId>org.springframework.boot</groupId> 


<artifactId>spring-boot-starter-jetty</artifactId> 
</dependency> 

主要 是 从 spring-boot-starter-web 中 除去 默认 的 Tomcat， 然后 加 入 Jetty 的 依赖 即 可 。 此 时 启动 
项 目 ， 查 看 启动 日 志 ， 如 图 2-8 所 示 。 











第 2 章 Spring Boot 基础 配置 | 21 








FrameworkServlet "dispatcherServlet” : initialization completed in 17 ms 
Started ServerConnector®@2617f816 {HTIP/1.1, [http/1.1]} {0. 0.0.0:8080} 
Jetty started on port(s) 8080 (http/1.1) with context path “用 

Started Chapter013Application in 8.447 seconds (JVM ruming for 9.865) 











图 2-8 


2.4.3 Undertow 配置 


Undertow 是 一 个 红 帽 公司 开源 的 Java 服务 器 , 具有 非常 好 的 性 能 , 在 Spring Boot 中 也 得 到 了 
很 好 的 支持 ， 配 置 方式 与 Jetty 类 似 ， 代 码 如 下 : 


<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 
<exclusions> 

<exclusion> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-tomcat</artifactId> 
</exclusion> 

</exclusions> 

</dependency> 

<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-undertow</artifactId> 
</dependency> 


启动 后 查看 日 志 ， 如 图 2-9 所 示 。 


Fowmawmmwm 
Po 


请 上 
WN 











上 
心 


Mapped URL path [/iek] onto handler of type [class org. springframework.we 


Registering beans for JIK exposure on startup 


Undertow started on port(s) 8080 (http) with context path ”” 
Started Chapter01l3Application in 6.998 seconds (JVM ruming for 8.749) 


图 2-9 





2.5 ”Properties 配置 


Spring Boot 中 采用 了 大 量 的 自动 化 配置 ， 但 是 对 开发 者 而 言 ， 在 实际 项 目 中 不 可 避免 会 有 一 
些 需 要 自己 手动 配置 ， 承 载 这 些 自 定义 配置 的 文件 就 是 resources 目录 下 的 application.properties 文 
件 (也 可 以 使 用 YAML 配置 来 替代 application.properties 配置 ，YAML 配置 将 在 2.7 节 介 绍 ) 。 在 
2.4 节 的 Web 容器 配置 中 ， 读 者 已 经 见识 到 application.properties 配置 的 基本 用 法 了 ， 本 节 将 对 
application.properties 的 使 用 做 进一步 的 介绍 。 
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Spring Boot 项 目 中 的 application.properties 配置 文件 一 共 可 以 出 现在 如 下 4 个 位 置 : 


e@ 项 目 根 目录 下 的 config 文件 夫 中 。 
@ 项目 根 目 录 下 。 

e@ classpath 下 的 config 文件 夹 中 。 

® classpath 下 。 


如 果 这 4 个 位 置 中 都 有 application.properties 文件 ， 那 么 加 载 的 优先 级 从 1 到 4 依次 降低 ， 如 
2-10 所 示 。Spring Boot 将 按照 这 个 优先 级 查找 配置 信息 ， 并 加 载 到 Spring Environment 中 。 


v Mchapter02-2 D:\workspace\book\chapter02-2 
jdea 
mw 
config 
@@ application.properties 
src 


MM main 
* Mjava 
Wresources 3 


Y bconfg a 
@ application.properties 
static 

3 templates 4 
application.properties 
test 

出 .gitignore 

多 application.properties 二 一 2 

chapter02-2iml 

二 mww 


时 mvnwcmd 





站 pomxml 


图 2-10 


如 果 开发 者 在 开发 中 未 使 用 application.properties， 而 是 使 用 了 application.yml 作为 配置 文件 ， 
那么 配置 文件 的 优先 级 与 图 2-10 一 致 。 

默认 情况 下 ，Spring Boot 按照 图 2-10 的 顺序 依次 查找 application.properties 并 加 载 。 如 果 开发 
者 不 想 使 用 application.properties 作为 配置 文件 名 ， 也 可 以 自己 定义 。 例 如 ， 在 resources 目录 下 创 
建 一 个 配置 文件 app.properties， 然 后 将 项 目 打 成 jar 包 ， 打 包 成 功 后 ， 使 用 如 下 命令 运行 : 


生 [ java -jar chapter02-2-0.0.1-SNAPSHOT.jar --spring.config.name=app 


在 运行 时 再 指定 配置 文件 的 名 字 。 使 用 spring.config.location 可 以 指定 配置 文件 所 在 目录 ( 注 
意 需要 以 /结束 ) ， 代 码 如 下 : 











1 java -jar chapter02-2-0.0.1-SNAPSHOT.jar --spring.config.name=app 
--spring.config.location=classpath:/ 











2.6 ”类 型 安全 配置 属性 


在 2.5 节 中 ,读者 已 经 了 解 到 无 论 是 Properties 配置 还 是 YAML 配置 ,最 终 都 会 被 加 载 到 Spring 
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Environment 中 。Spring 提供 了 @Value 注解 以 及 EnvironmentAware 接口 来 将 Spring Environment 
中 的 数据 注入 到 属性 上 ,Spring Boot 对 此 进一步 提出 了 类 型 安全 配置 属性 (Type-safe Configuration 
Properties) ， 这 样 即使 在 数据 量 非常 庞大 的 情况 下 ， 也 可 以 更 加 方便 地 将 配置 文件 中 的 数据 注入 
Bean 中 。 考 虑 在 application.properties 中 添加 如 下 一 段 配置 : 








book.name= 三 国 演义 
和 2 book.author= 罗 贯 中 
book.price=30 





将 这 一 段 配置 数据 注入 如 下 Bean 中 : 


QComponent 
ConfigurationProperties (prefix = "book") 
public class Book { 

private String name; 

private String author; 

private Float price; 

// 省 略 getter/setter 











Dowcwm 





代码 解释 : 


ee @ConfigurationProperties 中 的 prefix 属性 描述 了 要 加 载 的 配置 文件 的 前 级 。 

。 如 果 配 置 文件 是 一 个 YAML 文件 , 那么 可 以 将 数据 注入 一 个 集合 中 。 YAML 将 在 2.7 节 介 绍 。 

e Spring Boot 采用 了 一 种 宽松 的 规则 来 进行 属性 绑 定 ， 如 果 Bean 中 的 属性 名 为 authorName， 
那么 配置 文件 中 的 属性 可 以 是 book.author name、book.author-name、book.authorName 或 者 
book.AUTHORNAME. 


以 上 的 配置 可 能 会 乱码 , 需要 对 中 文 进行 转 码 。 在 IntelliJ IDEA 中 ， 这 个 转 码 非常 容易 ， 在 
setting 配置 中 进行 简单 配置 即 可 ， 如 图 2-11 所 示 。 





最 后 创建 BookController 进行 简单 测试 : 


@RestController 

public class BookController { 
Q@Autowired 
Book book; 


QGetMapping ("/book" 
public String book() { 
return book.toString(); 


} 





注入 Book， 并 将 实例 输出 ， 如 图 2-12 所 示 。 
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Settings 总 





人 Q Editor » File Encodings :For current project 


» Appearance & Behavior Global Encoding: [UTF-8 


Keymap Project Encoding: [UIFSz)A 
r Editor Path< Encoding | 十 
和 | sD:\workspace\book\chapter022-3 UTF-8 
> General 


bp Colors & Fonts 
» Code Style 
Inspections 


File and Code Templates To change encoding Intelli] IDEA uses for a file or directory, click an item and then select encoding 
from the encoding list Built-in file encoding (e.g. JSP, HTML or XML) overrides encoding you specify 
here. If not specified, files and directories inherit encoding settings from the parent directory or from 


the Project Encoding. 





Live Templates 


File Types Properties Files (*.properties) We 

i it 3 5- = S 
miessd beyont ioe Defauk encoding for properties files: | UTF-8r Transparent native-to-ascii conversion 
Copyright 国 


WE [ee 


| Lasp | 





)/ 盟 localhost:8080/book 


€ GC 合 | © localhost:8080/book 


Book{name=' 三 国 演义 ', author=' 罗 贯 中 , price=30.0} 





图 2-12 


2.7 YAML 配置 


2.7.1 常规 配置 


YAML 是 JSON 的 超 集 ， 简 洁 而 强大 ， 是 一 种 专门 用 来 书写 配置 文件 的 语言 ， 可 以 替代 
application properties。 在 创建 一 个 Spring Boot 项 目 时 , 引入 的 spring-boot-starter-web 依赖 间接 地 引 
入 了 snakeyaml 依赖 ，snakeyaml 会 实现 对 YAML 配置 的 解析 。YAML 的 使 用 非常 简单 ， 利 用 缩 进 
来 表示 层级 关系 ， 并 且 大 小 写 敏感 。 在 Spring Boot 项 目 中 使 用 YAML 只 需要 在 resources 目录 下 
创建 一 个 application.yml 文件 即 可 ， 然 后 向 application.yml 中 添加 如 下 配置 : 








server: 
port: 80 
servlet: 
context-path: /chapter02 
tomcat: 
uri-encoding: utf-8 





1 
2 
3 
4 
5 
6 





这 一 段 配置 等 效 于 application properties 中 的 如 下 配置 : 
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1 server .port=80 
区 server.servlet.context-path=/chapter02 








3 | server.tomcat.uri-encoding=utf-8 





此 时 可 以 将 resources 目录 下 的 application.properties 文件 删除 ， 完 全 使 用 YAML 完成 文件 的 
配置 。 


2.7.2 ”复杂 配置 


YAML 不 仅 可 以 配置 常规 属性 ， 也 可 以 配置 复杂 属性 ， 例 如 下 面 一 组 配置 : 





1 | my: 
要 name : 江南 一 点 雨 
二 address: China 





像 Properties 配置 文件 一 样 ， 这 一 段 配置 也 可 以 注入 一 个 Bean 中 ， 代 码 如 下 : 


QComponent 
Q@ConfigurationProperties (prefix = "my") 
public class User { 

private String name; 

private String address; 
// 省 略 getter/setter 
} 


YAML 还 支持 列表 的 配置 ， 例 如 下 面 一 组 配置 : 


my: 
name: 江南 一 点 雨 
address: China 
favorites: 





amwwm 





amewm 


这 一 组 配置 可 以 注入 如 下 Bean 中 : 





QComponent 
QConfigurationProperties (prefix = "my" 
public class User { 

private String name; 

private String address; 

private List<String> favorites; 
// 省 略 getter/setter 
} 


YAML 还 支持 更 复杂 的 配置 ， 即 集合 中 也 可 以 是 一 个 对 象 ， 例 如 下 面 一 组 配置 : 


1 
2 
3 
4 
5 
6 
8 








my: 
users: 
- name: 江南 一 点 十 


address: China 








心 ww NB 





26 | Spring Boot+Vue 全 栈 开 发 实战 








时 favorites: 

6 - 足球 

7 - 徒步 

8 - Coding 

9 - name: sang 
10 address: GZ 
Fy favorites: 

12 - 阅读 

13 - 吉他 





这 组 配置 在 集合 中 放 的 是 一 个 对 象 ， 因 此 可 以 注入 如 下 集合 中 : 





1 @Component 

归 @ConfigurationProperties (prefix = "my") 
3 |public class Users { 

4 private List<User> users; 

5 | // 省 略 getter/setter 

6 |} 

7 |public class User { 

8 private String name; 

9 private String address; 

10 private List<String> favorites; 
11 | // 省 略 getter/setter 











在 Spring Boot 中 使 用 YAML 虽然 方便 ， 但 是 YAML 也 有 一 些 缺 陷 ， 例 如 无 法 使 用 
@PropertySource 注解 加 载 YAML 文件 ， 如 果 项 目 中 有 这 种 需求 ， 还 是 需要 使 用 Properties 格式 的 
配置 文件 。 


2.8 Profile 


开发 者 在 项 目 发 布 之 前 ， 一 般 需 要 频繁 地 在 开发 环境 、 测 试 环境 以 及 生产 环境 之 间 进 行 切换 ， 
这 个 时 候 大 量 的 配置 需要 频繁 更 改 ， 例 如 数据 库 配 置 、redis 配置 、mongodb 配置 、jms 配置 等 。 频 
繁 修改 带 来 了 巨大 的 工作 量 ，Spring 对 此 提供 了 解决 方案 (@Profile 注解 ) ，Spring Boot 则 更 进 一 
步 提供 了 更 加 简洁 的 解决 方案 ，Spring Boot 中 约定 的 不 同 环境 下 配置 文件 名 称 规则 为 
application-{profile} .properties，profile 占 位 符 表 示 当 前 环境 的 名 称 ， 有 具体 配置 步骤 如 下 : 


1. 创建 配置 文件 


首先 在 resources 目录 下 创建 两 个 配置 文件 : application-dev.properties 和 application-prod. 
properties， 分 别 表示 开发 环境 中 的 配置 和 生产 环境 中 的 配置 。 其 中 ，application-dev.properties 文件 
的 内 容 如 下 : 


1 | server .port=8080 














application-prod.properties 文件 的 内 容 如 下 : 
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1 | server.port=80 
这 里 为 了 简化 问题 并 且 容 易 看 到 效果 ， 两 个 配置 文件 中 主要 修改 了 一 下 项 目 端口 号 。 
2. 配置 application.properties 
然后 在 application.properties 中 进行 配置 : 

















| spring.profiles.active=dev 


这 个 表示 使 用 application-dev.properties 配置 文件 启动 项 目 ， 若 将 dev 改 为 prod， 则 表示 使 用 
application-prod.properties 启动 项 目 。 项 目 启动 成 功 后 ， 就 可 以 通过 相应 的 端口 进行 访问 了 。 


3. 在 代码 中 配置 


对 于 第 二 步 在 application.properties 中 添加 的 配置 ， 我 们 也 可 以 在 代码 中 添加 配置 来 完成 ， 在 
启动 类 的 main 方法 上 添加 如 下 代码 ， 可 以 蔡 换 第 二 步 的 配置 : 








SpringApplicationBuilder builder = new 
SpringApplicationBuilder (Chapter013Application.class); 


builder.application() .setAdditionalProfiles ("prod"); 
builder.run (args); 


4. 项 目 启动 时 配置 


对 于 第 2 步 和 第 3 步 提 到 的 两 种 配置 方式 ， 也 可 以 在 将 项 目 打 成 jar 包 后 启动 时 ， 在 命令 行动 
态 指定 当前 环境 ， 示 例 命令 如 下 : 











java -jar chapter01-3-0.0.1-SNAPSHOT.jar --spring.profiles.active=prod 


2.9 小 结 


本 章 主 要 向 读者 介绍 了 Spring Boot 常见 的 基础 性 配置 ， 包 括 依赖 管理 的 多 种 方式 ， 如 入 口 类 
注解 、banner 定制 、Web 容器 配置 以 及 Properties 配置 和 YAML 配置 等 ， 这 些 配置 将 是 后 面 章节 
的 基础 。 第 3 章 将 向 读者 介绍 使 用 Spring Boot 整合 视图 层 技术 。 


Spring Boot 整合 视图 层 技 术 


本 章 概 要 


@ 整合 Thymeleaf 
@ ”整合 FreeMarker 


在 目前 的 企业 级 应 用 开发 中 ,前 后 端 分 离 是 趋势 ,但 是 视图 层 技 术 还 占有 一 席 之 地 。Spring Boot 
对 视图 层 技术 提供 了 很 好 的 支持 ， 官 方 推荐 使 用 的 模板 引擎 是 Thymeleaf，, 不 过 像 FreeMarker 也 支 
持 , JSP 技术 在 这 里 并 不 推荐 使 用 。 下 面 分 别 向 读者 介绍 Spring Boot 整合 Thymeleaf 和 FreeMarker 
两 种 视图 层 技术 。 


3.1 整合 Thymeleaf 


Thymeleaf 是 新 一 代 Java 模板 引擎 ， 类 似 于 Velocity、FreeMarker 等 传统 Java 模板 引擎 。 与 传 
统 Java 模板 引擎 不 同 的 是 ，Thymeleaf 支持 HTML 原型 ， 既 可 以 让 前 端 工程 师 在 浏览 器 中 直接 打 
开 查 看 样式 , 也 可 以 让 后 端 工程 师 结合 真实 数据 查看 显示 效果 。 同时 , Spring Boot 提供 了 Thymeleaf 
自动 化 配置 解决 方案 , 因此 在 Spring Boot 中 使 用 Thymeleaf 非常 方便 。Spring Boot 整合 Thymeleaf 
主要 可 通过 如 下 步 又 : 

1. 创建 工程 ， 添 加 依赖 


新 建 一 个 Spring Boot 工程 ， 然 后 添加 spring-boot-starter-web 和 spring-boot-starter-thymeleaf 依 
赖 ， 代 码 如 下 : 
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<dependency> 

<groupId>org. springframework.boot</groupId> 
<artifactId>spring-boot-starter-thymeleaf</artifactId> 
</dependency> 

<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 
</dependency> 


2. 配置 Thymeleaf 


Spring Boot 为 Thymeleaf 提供 了 自动 化 配置 类 ThymeleafAutoConfiguration， 相 关 的 配置 属性 
在 ThymeleafProperties 类 中 ，ThymeleafProperties 部 分 源码 如 下 : 








cawmemwm 








QConfigurationProperties (prefix = "spring.thymeleaf") 

public class ThymeleafProperties { 
Private static final Charset DEFAULT ENCODING = StandardCharsets.UTF 8; 
public static final String DEFAULT PREFIX = "classpath:/templates/"; 
public static final String DEFAULT SUFFIX = ".html"; 


世 
2 
可 
4 
5 
6 
了 
8 





由 此 配置 可 以 看 到 ， 默 认 的 模板 位 置 在 classpath:/templates/， 默 认 的 模板 后 绥 为 .html。 如 果 使 
用 IntelliJIDEA 工具 创建 Spring Boot 项 目 ，templates 文件 夹 默认 就 会 创建 。 

当然 ， 如 果 开 发 者 想 对 默认 的 Thymeleaf 配置 参数 进行 自 定义 配置 ， 那么 可 以 直接 在 
application.properties 中 进行 配置 ， 部 分 常见 配置 如 下 : 











1 | # 是 否 开启 缓存 ， 开 发 时 可 设置 为 false， 默 认为 true 

2 spring.thymeleaf .cache=true 

3 “| # 检 查 模板 是 否 存在 ， 默 认为 true 

4 spring.thymeleaf.check-template=true 

5 | # 检 查 模板 位 置 是 否 存在 ， 默 认为 true 

6 spring.thymeleaf.check-template-location=true 
7 “| # 模 板 文件 编码 

8 spring.thymeleaf .encoding=UTF-8 

9 “| # 模 板 文件 位 置 

10 | spring.thymeleaf .prefix=classpath:/templates/ 
11 | #Content-Type 配置 

12 | spring.thymeleaf.servlet.content-type=text/html 
13 | # 模 板 文件 后 绥 

14 | spring.thymeleaf.suffix=.html 





3. 配置 控制 器 
创建 Book 实体 类 ， 然 后 在 Controller 中 返回 ModelAndView， 代 码 如 下 : 








1 public class Book { 

发 private Integer id; 

3 private String name; 

4 private String author7 
5 // 省 略 getter/setter 
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6 } 

和 @Controller 

8 public class BookController { 

9 Q@GetMapping ("/books") 

10 public ModelAndView books() { 

Ty List<Book> books = new ArrayList<>(); 
12 Book bl = new Book(); 

3 bl.setId(1); 

14 bl1.setAuthor ("罗贯中 "); 

15 bl .setName ("三 国 演义 ") ; 

16 Book b2 = new Book(); 

了 7 b2.setId(2); 

18 b2.setRuthor ("曹雪芹 "); 

19 b2 .setName ("红楼 梦 ") ; 

20 books.add (b1); 

21 books.add (b2); 

22 ModelAndView mv = new ModelAndView(); 
23 mv.addObject ("books", books); 

24 mv.setViewName ("books"); 

25 return mV7 











代码 解释 : 

e 创建 Book 实体 类 ， 承 载 返回 数据 。 

e 在 BookController 中 , 第 11~21 行 构建 返回 数据 ， 第 22~25 行 创建 返回 ModelAndView, 设置 
视图 名 为 books， 返 回 数据 为 所 创建 的 List 集合 。 

4. 创建 视图 

在 resources 目录 下 的 templates 目录 中 创建 bookshtml， 有 具体 代码 如 下 : 











<!DOCTYPE html> 

2 <html lang="en" xmlns:th="http://www.thymeleaf .org"> 
3 <head> 

4 <meta charset="UTF-8"> 

5 | <title> 图 书 列表 </title> 

6 |</head> 

村 <body> 

8 <table border="1"> 

9 <tr> 

10 | <td> 图 书 编号 </td> 

11 | <td> 图 书 名 称 </td> 

12 | <td> 图 书 作者 </td> 

13 | </tr> 

14 | <tr th:each="book:${books}"> 

15 | <td th:text="${book.id}"></td> 

16 | <td th:text="${book.name}"></td> 
17 | <td th:text="${book.author}"></td> 
18 | </tr> 
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19 | </table> 
20 | </body> 
21 | </html> 

代码 解释 : 


e 首先 在 第 2 行 导入 Thymeleaf 的 名 称 空间 。 

@ 第 14~18 行 通过 遍历 将 books 中 的 数据 展示 出 来 ，Thymeleaf 中 通过 th:each 进行 集合 遍历 ， 
通过 th:text 展示 数据 。 

5. 运行 

在 浏览 器 地 址 栏 中 输入 “http://localhost:8080/books”， 即 可 看 到 运行 结果 ， 如 图 3-1 所 示 。 


/ gj 图书 列表 









































图 3-1 


本 节 重 点 介绍 Spring Boot 整合 Thymeleaf， 并 非 Thymeleaf 的 基础 用 法 ， 关 于 Thymeleaf 的 更 
多 资料 ， 可 以 查看 https://www.thymeleaf.org。 


3.2 整合 FreeMarker 


FreeMarker 是 一 个 非常 古老 的 模板 引擎 , 可 以 用 在 Web 环境 或 者 非 Web 环境 中 。 与 Thymeleaf 
不 同 , FreeMarker 需要 经 过 解析 才能 够 在 浏览 器 中 展示 出 来 。 FreeMarker 不 仅 可 以 用 来 配置 HTML 
页 面 模 板 ， 也 可 以 作为 电子 邮件 模板 、 配 置 文件 模板 以 及 源码 模板 等 。Spring Boot 中 对 FreeMarker 
整合 也 提供 了 很 好 的 支持 ， 主 要 整合 步骤 如 下 : 

1. 创建 项 目 ， 添 加 依赖 

首先 创建 Spring Boot 项 目 ， 然 后 添加 spring-boot-starter-web 和 spring-boot-starter-freemarker 
依赖 ， 代 码 如 下 : 


<dependency> 

<groupId>org. springframework.boot</groupId> 
<artifactId>spring-boot-starter-freemarker</artifactId> 
</dependency> 

<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 
</dependency> 





CE 
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2. 配置 FreeMarker 


Spring Boot 对 FreeMarker 也 提供 了 自动 化 配置 类 FreeMarkerAutoConfiguration， 相 关 的 配置 
属性 在 FreeMarkerProperties 中 ， FreeMarkerProperties 部 分 源码 如 下 : 





QConfigurationProperties (prefix = "spring.freemarker") 

public class FreeMarkerProperties extends AbstractTemplateViewResolverProperties { 
public static final String DEFAULT TEMPLATE LOADER PATH= "classpath:/templates/"; 
public static final String DEFAULT PREFIX = ""; 
public static final String DEFAULT SUFFIX = ".ftl"; 


CE 


} 





从 该 默认 配置 中 可 以 看 到 ，FreeMarker 默认 模板 位 置 和 Thymeleaf 一 样 ， 都 在 
classpath:/templates/ 中 ， 默 认 文 件 后 缀 是 . 包 。 开 发 者 可 以 在 application.properties 中 对 这 些 默 认 配 置 
进行 修改 ， 部 分 常见 配置 如 下 : 














1 | #8ttpServletRequest 的 属性 是 否 可 以 覆盖 controller 中 model 的 同名 项 

2 spring.freemarker.allow-request-override=false 

3 | #HttpSession 的 属性 是 否 可 以 覆盖 controller 中 model 的 同名 项 

4 spring.freemarker.allow-session-override=false 

5 | # 是 否 开启 缓存 

6 Spring.freemarker.cache=false 

7 “| # 模 板 文件 编码 

8 spring.freemarker.charset=UTF-8 

9 “| # 是 否 检查 模板 位 置 

10 | spring.freemarker.check-template-location=true 

11 | #Content-Type 的 值 

12 | spring.freemarker.content-type=text/html 

13 | # 是 否 将 HttpServletRequest 中 的 属性 添加 到 Model 中 

14 | spring.freemarker.expose-request-attributes=false 

15 | # 是 否 将 HttpSession 中 的 属性 添加 到 Model 中 

16 | spring.freemarker.expose-session-attributes=false 

17 | # 模 板 文件 后 级 

18 | spring.freemarker.suffix=.ftl 

19 | # 模 板 文件 位 置 

20 | spring.freemarker.template-loader-path=classpath:/templates/ 
3. 配置 控制 器 


控制 器 和 Thymeleaf 中 的 控制 器 一 样 ， 这 里 不 再 重复 。 
4. 创建 视图 
按照 配置 文件 ， 在 resources/templates 目录 下 创建 books .fl 文件 ， 内 容 如 下 : 


<!DOCTYPE html> 

<html lang="en"> 
<head> 

<meta charset="UTF-8"> 
<title> 图 书 列表 </title> 





2 
3 
4 
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6 | </head> 

过 <body> 

8 <table border="1"> 
9 <tr> 


10 | <td> 图 书 编号 </td> 

11 | <td> 图 书 名 称 </td> 

12 | <td> 图 书 作者 </td> 

13 | </tr> 

14 | <#if books ??&& (books?size>0)> 
15 | <#1ist books as book> 
16 | <tr> 

17 | <td>$ {book.id}</td> 

18 | <td>$ {book.name}</td> 
19 | <td>$ {book.author}</td> 
20 | </tr> 

21 | </#1ist> 

22 | </#if> 

23 | </table> 

24 | </body> 

25 | </html> 


代码 解释 : 
@ 第 14 行 首先 判断 model 中 的 books 不 为 空 并 且 books 中 有 数据 ， 然 后 进行 遍历 。 
e 第 15~21 行 表示 遍历 books 集合 , 将 集合 中 的 数 

据 通过 表格 展示 出 来 。 |/ 加 ge x 











a CO © localhost8080/books 
































5. 运行 

在 浏览 器 中 输入 “http://localhost:8080/books”， 即 图 书 编号 图 书 名 称 图 书 作 者 | 
可 看 到 运行 结果 ， 如 图 3-2 所 示 。 1 | 三 国 演义 罗贯中 | 

本 节 重 点 介绍 Spring Boot 整合 FreeMarker， 并 非 LE re 区 8s# | 
FreeMarker 的 基础 用 法 ， 关 于 FreeMarker 的 更 多 资料 ， 图 3-2 


可 以 查看 https://freemarker.apache.org/。 
3.3 小 结 


本 章 向 读者 介绍 了 Spring Boot 整合 视图 层 技术 ， 选 择 了 两 个 具有 代表 性 的 例子 : Thymeleaf 
和 FreeMarker。 开 发 者 用 到 其 他 模板 技术 时 ， 整 合 方式 和 Thymeleaf、FreeMarker 基本 一 致 。 如 果 
开发 者 使 用 的 是 目前 流行 的 前 后 端 分 离 技术 , 那么 在 开发 过 程 中 不 需要 整合 视图 层 技术 , 后 端 直接 
提供 接口 即 可 。 第 4 章 将 向 读者 介绍 Spring Boot 整合 Web 开发 的 其 他 细节 。 


Spring Boot 整合 Web 开发 


本 章 概 要 
日 返回 JSON 数据 日 “启动 系统 任务 
@ 静态 资源 访问 @ 整合 Servlet、Filter 和 Listener 
@ 文件 上 传 @ ”路径 映 射 
® (@ControllerAdvice e 配置 AOP 
@ 自 定义 错误 页 @ 自 定义 欢 迎 页 
e@ CORS 支持 @ 自 定义 favicon 
e 配置 类 与 XML 配置 日 ”除去 某 个 自动 配置 
日 ”注册 拦截 器 


4.1 返回 JSON 数据 


4.1.1 默认 实现 





JSON 是 目前 主流 的 前 后 端 数据 传输 方式 ，Spring MVC 中 使 用 消息 转换 器 
HttpMessageConverter 对 JSON 的 转换 提供 了 很 好 的 支持 ,在 Spring Boot 中 更 进一步 ， 对 相关 配置 
做 了 更 进一步 的 简化 。 默 认 情 况 下 ， 当 开发 者 新 创建 一 个 Spring Boot 项 目 后 ， 添 加 Web 依赖 ， 代 
码 如 下 : 
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必 wm 上 


<dependency> 

<groupId>org. springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 
</dependency> 





理 器 就 能 返回 一 段 JSON 了 。 创 建 一 个 Book 实体 类 : 


这 个 依赖 中 默认 加 入 了 jackson-databind 作为 JSON 处 理 器 ， 此 时 不 需要 添加 额外 的 JSON 处 














OooODp 





PpooIoNAoDPp 
Po 


上 
MD 





卢 
Co 


蔡 @Controller 和 @ResponseBody， 代 码 如 下 : 





public class Book { 
private String name; 
private String author; 
@JsonIgnore 
private Float price; 
QJsonFormat (pattern = "yyyy-MM-dd") 
private Date publicationDate; 
// 省 略 getter/setter 


然后 创建 BookController， 返 回 Book 对 象 即 可 : 


@Controller 
public class BookController { 
@GetMapping ("/book") 
Q@ResponseBody 
public Book book() { 
Book book = new Book(); 
book. setAuthor ("罗贯中 ") ; 
book. setName ("三 国 演义 "); 
book. setPrice (30f); 
book.setPublicationDate (new Date()); 
return book; 








当然 ， 如 果 需 要 频繁 地 用 到 @ResponseBody 注解 ， 那 么 可 以 采用 @RestController 组 合 注解 代 





和 
2 
3 
4 
5 
6 
时 
8 
a 





@RestController 
public class BookController { 
QGetMapping ("/book" 
public Book book() { 
Book book = new Book(); 
book.setAuthor ("罗贯中 "); 
book. setName (" bd 
book. setPrice (30f); 
book. setPublicationDate (new Date()); 
return book; 











此 时 ， 在 浏览 器 中 输入 “http://localhost:8080/book”， 即 可 看 到 返回 了 JSON 数据 ， 如 图 4-1 


所 示 。 
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7 el localhost808o/book x Ws 





Es GC 全 | © localhost:8080/book 


{"name”: "三国 演 义 ", "author”: “罗贯中 ”, "publicationDate”: “2018-07-08”} 





图 4-1 


这 是 Spring Boot 自 带 的 处 理 方式 。 如 果 采 用 这 种 方式 ， 那 么 对 于 字段 忽略 、 日 期 格式 化 等 常 
见 需求 都 可 以 通过 注解 来 解决 。 

这 是 通过 Spring 中 默认 提供 的 MappingJackson2HttpMessageConverter 来 实现 的 ， 当 然 开 发 者 
在 这 里 也 可 以 根据 实际 需求 自 定义 JSON 转换 器 。 





4.1.2” 自 定义 转换 器 


常见 的 JSON 处 理 器 除了 jackson-databind 之 外 ， 还 有 Gson 和 fastjson， 这 里 针对 常见 用 法 分 
别 举例 。 


1. 使 用 Gson 


Gson 是 Google 的 一 个 开源 JSON 解析 框架 。 使 用 Gson， 需 要 先 除 去 默认 的 jackson-databind， 
然后 加 入 Gson 依赖 ， 代 码 如 下 : 


<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 
<exclusions> 

<exclusion> 
<groupId>com. fasterxml .jackson.core</groupId> 
<artifactId>jackson-databind</artifactId> 
</exclusion> 

</exclusions> 

</dependency> 

<dependency> 
<groupId>com.google.code.gson</groupId> 
<artifactId>gson</artifactId> 

</dependency> 


FFPiDomnawmmwm 
情书 


记忆 
WON 





> 








由 于 Spring Boot 中 默认 提供 了 Gson 的 自动 转换 类 GsonHttpMessageConvertersConfiguration， 
因此 Gson 的 依赖 添加 成 功 后 , 可 以 像 使 用 jackson-databind 那样 直接 使 用 Gson。 但 是 在 Gson 进行 
转换 时 ， 如 果 想 对 日 期 数据 进行 格式 化 ， 那 么 还 需要 开发 者 自 定义 HttpMessageConverter。 自 定义 
HttpMessageConverter 可 以 通过 如 下 方式 。 

首先 看 GsonHttpMessageConvertersConfiguration 中 的 一 段 源码 : 








@Bean 

Q@ConditionalOnMissingBean 

public GsonHttpMessageConverter gsonHttpMessageConverter (Gson gson) { 
GsonHttpMessageConverter converter = new GsonHttpMessageConverter(); 





PAODP 
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5 converter .setGson (gson); 
6 return converter; 
了 





@ConditionalOnMissingBean 注解 表示 当 项 目 中 没有 提供 GsonHttpMessageConverter 时 才 会 使 
用 默认 的 GsonHttpMessageConverter, 所 以 开发 者 只 需要 提供 一 个 GsonHttpMessageConverter 即 可 ， 
代码 如 下 : 


@Configuration 
public class GsonConfig { 
QBean 
GsonHttpMessageConverter gsonHttpMessageConverter() { 
GsonHttpMessageConverter converter = new GsonHttpMessageConverter (); 
GsonBuilder builder = new GsonBuilder (); 
builder.setDateFormat ("yyyy-MM-dd"); 
builder.excludeFieldsWithModifiers (Modifier .PROTECTED); 
Gson gson = builder.create(); 
10 converter.setGson (gson); 
六 return converter; 








OooODp 











代码 解释 : 


开发 者 自己 提供 一 个 GsonHttpMessageConverter 的 实例 。 

设置 Gson 解析 时 日 期 的 格式 。 

设置 Gson 解析 时 修饰 符 为 protected 的 字段 被 过 滤 掉 。 

创建 Gson 对 象 放 入 GsonHttpMessageConverter 的 实例 中 并 返回 converter。 


此 时 ， 将 Book 类 中 的 price 字段 的 修饰 符 改 为 protected， 代 码 如 下 : 


public class Book { 
private String name; 
private String author; 
protected Float price; 
private Date publicationDate; 
// 省 略 getter/setter 





最 后 ， 在 浏览 器 中 输入 “http://localhost:8080/book”， 即 可 看 到 运行 结果 ， 如 图 4-2 所 示 。 





@ localhost:8080/book x™W 





和 GC 合 | © localhost:8080/book 


{"name”: “二 国 演义 ”, “author”: “罗贯中 *, “publicationDate”: “2019-07-08”} 





图 4-2 


2. 使 用 fastjson 
fastjson 是 阿里 巴巴 的 一 个 开源 JSON 解析 框架 ， 是 目前 JSON 解析 速度 最 快 的 开源 框架 ， 该 
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框架 也 可 以 集成 到 Spring Boot 中 。 不 同 于 Gson，fastjson 继承 完成 之 后 并 不 能 立马 使 用 ， 需 


发 者 提供 相应 的 HttpMessageConverter 后 才能 使 用 ， 集 成 fastjson 的 步骤 如 下 。 


首先 除去 jackson-databind 依赖 ， 引 入 fastjson 依赖 : 





oOoODp 








<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 
<exclusions> 

<exclusion> 
<groupId>com. fasterxml .jackson.core</groupId> 
<artifactId>jackson-databind</artifactId> 
</exclusion> 

</exclusions> 

</dependency> 

<dependency> 

<groupId>com.alibaba</groupId> 
<artifactId>fastjson</artifactId> 
<version>1.2.47</version> 

</dependency> 





然后 配置 fastjson 的 HttpMessageConverter: 


@Configuration 
public class MyFastJsonConfig { 
QBean 
FastJsonHttpMessageConverter fastJsonHttpMessageConverter() { 


FastJsonConfig config = new FastJsonConfig(); 

config.setDateFormat ("yyyy-MM-dd"); 

config.setCharset (Charset .forName ("UTF-8")); 

config.setSerializerFeatures( 
SerializerFeature.WriteClassName, 
SerializerFeature.WriteMapNullValue, 
SerializerFeature.PrettyFormat, 
SerializerFeature.WriteNullListAsEmpty, 
SerializerFeature.WriteNullSstringAsEmpty 

); 

converter.setFastJsonConfig (config); 

return converter; 


代码 解释 : 


@ 自 定义 MyFastJsonConfig， 完 成 对 FastJsonHttpMessageConverter Bean 的 提供 。 


FastJsonHttpMessageConverter converter = new FastJsonHttpMessageConverter (); 





e ”第 7~15 行 分 别 配 置 了 JSON 解析 过 程 的 一 些 细节 ， 例 如 日 期 格式 、 数 据 编码 、 是 否 在 生成 的 
JSON 中 输出 类 名 、 是 否 输出 value 为 null 的 数据 、 生 成 的 JSON 格式 化 、 空 集合 输出 [] 而 非 


null、 空 字符 串 输 出 "而 非 null 等 基本 配置 。 


MyFastJsonConfig 配置 完成 后 ， 还 需要 配置 一 下 响应 编码 ， 否 则 返回 的 JSON 中 文 会 乱码 , 在 
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application.properties 中 添加 如 下 配置 : 
L spring.http.encoding.force-response=true 


接 下 来 提供 BookController 进行 测试 。BookController 和 上 一 小 节 一 致 ， 运 行 成 功 后 ， 在 浏览 
器 中 输入 “http://localhost:8080/book”， 即 可 看 到 运行 结果 ， 如 图 4-3 所 示 。 








) localhost:8080/book x 


所 GC 合 OO localhost:808 








{ "@type"…:"org.sang.Book"，"author":" 罗 贯 中 "name":"，"price":30.0F "publicationDate":"2018-07-09" } 








图 4-3 





对 于 FastJsonHttpMessageConverter 的 配置 ， 除 了 上 面 这 种 方式 之 外 ， 还 有 另 一 种 方式 。 

在 Spring Boot 项 目 中 ， 当 开发 者 引入 _ spring-boot-starter-web 依赖 之 后 ， 该 依赖 又 依赖 了 
spring-boot-autoconfigure， 在 这 个 自动 化 配置 中 ， 有 一 个 WebMvcAutoConfiguration 类 提供 了 对 
Spring MVC 最 基本 的 配置 ， 如 果 某 一 项 自动 化 配置 不 满足 开发 需求 ， 开 发 者 可 以 针对 该 项 自 定义 
配置 ， 只 需要 实现 WebMvcConfigurer 接口 即 可 (在 Spring 5.0 之 前 是 通过 继承 
WebMvcConfigurerAdapter 类 来 实现 的 ) ， 代 码 如 下 : 

















l @Configuration 
2 | public class MyWebMvcConfig implements WebMvcConfigurer { 
E, QOverride 
4 public void configureMessageConverters (List<HttpMessageConverter<?>> 
5 converters) { 
6 FastJsonHttpMessageConverter converter = new FastJsonHttpMessageConverter (); 
学 FastJsonConfig config = new FastJsonConfig() 
8 config.setDateFormat ("yyyy-MM-dd"); 
9 config.setCharset (Charset .forName ("UTF-8")); 
10 config.setSerializerFeatures( 
11 SerializerFeature.WriteClassName, 
又 SerializerFeature.WriteMapNullValue, 
13 SerializerFeature.PrettyFormat, 
14 SerializerFeature.WriteNullListAsEmpty, 
15 SerializerFeature.WriteNullSstringAsEmpty 
16 ); 
了 converter.setFastJsonConfig (config); 
18 converters.add (converter); 
19 于 
} 
代码 解释 : 
ee 自 定义 MyWebMvcConfig 类 并 实现 WebMvcConfigurer 接口 中 的 configureMessageConverters 


@ 将 自 定义 的 FastJsonHttpMessageConverter 加 入 converters 中 。 
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如 果 使 用 了 Gson， 也 可 以 采用 这 种 方式 配置 ， 但 是 不 推荐 。 因 为 当 项 目 中 没有 
GsonHttpMessageConverter 时 ，Spring Boot 自己 会 提供 一 个 GsonHttpMessageConverter， 此 


时 重 写 configureMessageConverters 方法 ,参数 converters 中 已 经 有 GsonHttpMessageConverter 
的 实例 了 ,需要 替换 已 有 的 GsonHttpMessageConverter 实例 , 操作 比较 麻烦 , 所 以 对 于 Gson， 
推荐 直接 提供 GsonHttpMessageConverter。 





4.2 ”静态 资源 访问 


在 Spring MVC 中 , 对 于 静态 资源 都 需要 开发 者 手动 配置 静态 资源 过 滤 。Spring Boot 中 对 此 也 
提供 了 自动 化 配置 ， 可 以 简化 静态 资源 过 滤 配置 。 


4.2.1 默认 策略 


Spring Boot 中 对 于 Spring MVC 的 自动 化 配置 都 在 WebMvcAutoConfiguration 类 中 , 因此 对 于 
默认 的 静态 资源 过 滤 策 略 可 以 从 这 个 类 中 一 窥 完 竟 。 

在 WebMvcAutoConfiguration 类 中 有 一 个 静态 内 部 类 WebMvcAutoConfigurationAdapter， 实 现 

了 4.1 节 提 到 的 WebMvcConfigurer 接口 。WebMvcConfigurer 接口 中 有 一 个 方法 addResourceHandlers， 

是 用 来 配置 静态 资源 过 滤 的 。 方 法 在 WebMvcAutoConfigurationAdapter 类 中 得 到 了 实现 ， 部 分 核 




















1 |public void addResourceHandlers (ResourceHandlerRegistry registry) { 

4 

3 二 

4 String staticPathPattern = this.mvcProperties.getStaticPathPattern() 7 

5 if (!registry.hasMappingForPattern (staticPathPattern)) { 

6 customizeResourceHandlerRegistration( 

时 registry.addResourceHandler (staticPathPattern) 

8 .addResourceLocations (getResourceLocations ( 

9 this .resourceProperties.getStaticLocations ())) 

10 .SetCachePeriod (getSeconds (cachePeriod) ) 

和 .SetCacheControl (cacheControl)); 

2 } 

Fe; 

Spring Boot 在 这 里 进行 了 默认 的 静态 资源 过 滤 配 置 ， 其 中 staticPathPattern 默认 定义 在 

WebMvcProperties 中 ， 定 义 内 容 如 下 : 

1 | private String staticPathPattern = "/**"; 





this.resourceProperties.getStaticLocations0 获 取 到 的 默认 静态 资源 位 置 定义 在 ResourceProperties 
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中 ， 代 码 如 下 : 





Private static final String[] CLASSPRATH RESOURCE LOCRTIONS = { 
"classpath:/METRA-INF/resources/"，"classpath:/resources/"， 
3 | "classpath:/static/", "classpath:/public/" }; 





在 getResourceLocations 方法 中 ， 对 这 4 个 静态 资源 位 置 做 了 扩充 ， 代 码 如 下 : 


static String[] getResourceLocations (String[] staticLocations) { 
String[] locations = new String[staticLocations.length+ SERVLET LOCATIONS.1length]; 
System.arraycopy (staticLocations, 0, locations, 0, staticLocations.length); 
System.arraycopy (SERVLET LOCATIONS, 0, locations, staticLocations.length, 
SERVLET LOCATIONS.1length); 

return locations; 


amcwm 











} 


其 中 ，SERVLET_LOCATIONS 的 定义 是 一 个 {"/" } 。 

综 上 可 以 看 到 ，Spring Boot 默认 会 过 滤 所 有 的 静态 资源 ， 而 静态 资源 的 位 置 一 共有 5 个 ， 分 
别 是 "classpath:/META-INF/resources/"、 "classpath:/resources/"、 "classpath:/static/"、 "classpath:/public/" 
以 及 ""， 也 就 是 说 ， 开 发 者 可 以 将 静态 资源 放 到 这 5 个 位 置 中 的 任意 一 个 。 注 意 ， 按 照 定 义 的 顺 
序 , 5 个 静态 资源 位 置 的 优先 级 依次 降低 。 但 是 一 般 情况 下 ，Spring Boot 项 目 不 需 要 webapp 目录 ， 
所 以 第 5 个 "" 可 以 暂 不 考虑 。 

在 一 个 新 创建 的 Spring Boot 项 目 中 ,添加 了 spring-boot-starter-web 依赖 之 后 ， 在 resources 目 
录 下 分 别 创建 4 个 目录 ，4 个 目录 中 放 入 同名 的 静态 资源 (如 图 4-4 所 示 ， 数 字 表 示 不 同位 置 资 源 
的 优先 级 ) 。 





main 


Ml java 





resources 


v META-INF 
" Bi resources — 1 
a pl.png 
v public 4— 4 
号 pl.png 
Y 下 resources 丁 一 2 
pl.png 
7 Bstatc 0—) 
司 pl.png 
I templates 


风 application.properties 





图 4-4 


此 时 , 在 浏览 器 中 输入 “http://localhost:8080/pl.png” 即 可 看 到 classpath:/META-INF/resources/ 
目录 下 的 pl.png， 如 果 将 classpath:/META-INF/resources/ 目 录 下 的 pl.png 删除 ， 就 会 访问 到 
classpath:/resources/ 目 录 下 的 pl.png， 以 此 类 推 。 
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如 果 开 发 者 使 用 IntelliJ IDEA 创建 Spring Boot 项 目 ， 就 会 默认 创建 出 classpath:/static/ 目 录 ， 
静态 资源 一 般 放 在 这 个 目录 下 即 可 。 


4.2.2 自 定义 策略 

如 果 默 认 的 静态 资源 过 滤 策 略 不 能 满足 开发 需求 ， 也 可 以 自 定 义 静 态 资源 过 滤 策 略 ， 自 定义 
静态 资源 过 滤 策 略 有 以 下 两 种 方式 : 

1. 在 配置 文件 中 定义 

可 以 在 application.properties 中 直接 定义 过 滤 规 则 和 静态 资源 位 置 ， 代 码 如 下 : 





spring.mvc.static-path-pattern=/static/** 
2 | spring.resources.static-locations=classpath:/static/ 





过 滤 规 则 为 /static/**， 静 态 资源 位 置 为 classpath:/static/。 
重新 启动 项 目 , 在 浏览 器 中 输入 “http://localhost:8080/static/p1l.png”, 即 可 看 到 classpath:/static/ 
目录 下 的 资源 。 
2. Java 编码 定义 
也 可 以 通过 Java 编码 方式 来 定义 , 此 时 只 需要 实现 WebMvcConfigurer 接口 即 可 , 然后 实现 该 
接口 的 addResourceHandlers 方法 ， 代 码 如 下 : 
Q@Configuration 
public class MyWebMvcConfig implements WebMvcConfigurer { 


@Override 
public void addResourceHandlers (ResourceHandlerRegistry registry) { 


registry 
.addResourceHandler ("/static/**") 
.addResourceLocations ("classpath:/static/"); 





重新 启动 项 目 , 在 浏览 器 中 输入 “http://localhost:8080/static/p1.png”, 即 可 看 到 classpath:/static/ 
目录 下 的 资源 。 


4.3 文件 上 传 


Spring MVC 对 文件 上 传 做 了 简化 , 在 Spring Boot 中 对 此 做 了 更 进一步 的 简化 , 文件 上 传 更 为 
方便 。 

Java 中 的 文件 上 传 一 共 涉 及 两 个 组 件 ， 一 个 是 CommonsMultipartResolver ， 另 一 个 是 
StandardServletMultipartResolver， 其 中 CommonsMultipartResolver 使 用 commons-fileupload 来 处 理 
multipart 请 求 ， 而 StandardServletMultipartResolver 则 是 基于 Servlet 3.0 来 处 理 multipart 请 求 的 ， 
此 若 使 用 StandardServletMultipartResolver， 则 不 需要 添加 额外 的 jar 包 。Tomcat 7.0 开始 就 支持 
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Servlet 3.0 了 ， 而 Spring Boot 2.0.4 内 嵌 的 Tomcat 为 Tomcat 8.5.32， 因 此 可 以 直接 使 用 
StandardServletMultipartResolver。 而 在 Spring Boot 提供 的 文件 上 传 自 动 化 配置 类 MultipartAutoConfiguration 
中 ， 默 认 也 是 采用 StandardServletMultipartResolver， 部 分 源码 如 下 : 





public class MultipartAutoConfiguration { 


@Bean (name = DispatcherServlet .MULTIPART RESOLVER BEAN NAME) 
@ConditionalOnMissingBean (MultipartResolver.class) 
public StandardServletMultipartResolver multipartResolver() { 
StandardServletMultipartResolver multipartResolver = new 
StandardServletMultipartResolver (); 
multipartResolver 
10 | .setResolveLazily (this.multipartProperties.isResolveLazily()); 
i return multipartResolver; 
12 } 


oo 











根据 这 里 的 配置 可 以 看 出 ， 如 果 开 发 者 没有 提供 MultipartResolver， 那 么 默认 采用 的 
MultipartResolver 就 是 StandardServletMultipartResolver。 因 此 , 在 Spring Boot 中 上 传 文件 甚至 可 以 
做 到 零 配置 。 下 面 来 看 具体 上 传 过 程 。 





4.3.1 单 文件 上 传 


首先 创建 一 个 Spring Boot 项 目 并 添加 spring-boot-starter-web 依赖 。 
然后 在 resources 目录 下 的 static 目录 中 创建 一 个 upload.html 文件 ， 内 容 如 下 : 


<!DOCTYPE html> 

<html lang="en"> 

<head> 

<meta charset="UTF-8"> 

<title>Title</title> 

</head> 

<body> 

<form action="/upload" method="post" enctype="multipart/form-data"> 
<input type="file"” name="uploadFile" value=" 请 选择 文件 "> 
<input type="submit" value=" 上 传 "> 

</form> 

</body> 

</html> 


这 是 一 个 很 简单 的 文件 上 传 页 面 ， 上 传 接口 是 /upload， 注 意 请 求 方法 是 post，enctype 是 
multipart/form-data。 
接着 创建 文件 上 传 处 理 接口 ， 代 码 如 下 : 


于 @RestController 
public class FileUploadController { 
SimpleDateFormat sdf = new SimpleDateFormat ("yyyy/MM/dd/"); 


oo Dp 
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4 QPostMapping ("/upload") 

5 public String upload (MultipartFile uploadFile, HttpServletRequest req) { 
6 String realPath = 

7 req.getSession() .getServletContext () .getRealPath ("/uploadFile/"); 
8 String format = sdf.format (new Date()); 

9 File folder = new Filel(realPath + format); 

10 if (!folder.isDirectory()) { 

11 folder.mkdirs(); 

12 } 

13 String oldName = uploadFile.getOriginalFilename(); 

14 String newName = UUID.randomUUID() .toString() + 

15 | oldName.substring (oldName.lastIndexOf ("."), oldName.length()); 

16 try { 

17 uploadFile.transferTo (new File (folder, newName)); 

18 String filePath = req.getScheme() + "://" + req.getServerName() + ":" + 
19 | req.getServerPort() + "/uploadFile/" + format + newName; 

20 return filePath; 

21 } catch (IOException e) { 

22 e.pIintStackTrace (); 

23 } 

24 return "上 传 失 败 !"; 











代码 解释 : 


e 第 6~12 代码 表示 规划 上 传 文件 的 保存 路 径 为 项 目 运 行 目录 下 的 uploadFile 文件 夹 , 并 在 文件 
夹 中 通过 日 期 对 所 上 传 的 文件 归 类 保存 。 

@ 第 13~15 行 代码 表示 给 上 传 的 文件 重 命名 ， 这 是 为 了 避免 文件 重 名 。 

@ 第 17 行 是 文件 保存 操作 。 

@ 第 18~20 行 是 生成 上 传 文件 的 访问 路 径 ， 并 将 访问 路 径 返 回 。 


最 后 在 浏览 器 中 进行 测试 。 
运行 项 目 ， 在 浏览 器 中 输入 “http://localhost:8080/upload.html” 进 行文 件 上 传 ， 如 图 4-5 所 示 。 


Ps 
ye Te 


co GC 全 | © localhost:8080/upload.html 





请 选择 文件 | 未 选择 任何 文件 上 传 





图 4-5 





单 击 “ 请 选择 文件 ”按钮 上 传 文件 ， 文 件 上 传 成 功 后 ， 会 返回 上 传 文件 的 访问 路 径 ， 如 图 4-6 








iocalhost8080/upload x 


二 CO | © iocalhost8060/upload 


http://localhost:8080/uploadFile/2018/07/09/6b83905c-9dba-46d7-b92f-b2ace70e70f6jpg 





图 4-6 
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有 这 个 路 径 就 可 以 看 到 刚刚 上 传 的 图 片 ， 如 图 4-7 所 示 。 


全 6b83905c-9dba-45d7- x 








“a 





© O | © localhost 





图 4-7 


在 4.2 节 中 向 读者 介绍 过 静态 资源 位 置 除了 classpath 下 面 的 4 个 路 径 之 外 ， 还 有 一 个 " /"， 因 
此 这 里 的 图 片 虽然 是 静态 资源 却 可 以 直接 访问 到 。 

至 此 ， 一 个 简单 的 图 片上 传 逻辑 就 完成 了 ， 对 于 开发 者 而 言 ， 只 需要 专注 于 图 片上 传 的 业务 
逻辑 ， 而 不 需要 在 配置 上 花费 太 多 时 间 。 

当然 ， 如 果 开 发 者 需要 对 图 片上 传 的 细节 进行 配置 ， 也 是 允许 的 ， 代 码 如 下 : 








spring.servlet.multipart .enabled=true 
spring.servlet.multipart.file-size-threshold=0 
spring.servlet .multipart.location=E:\\temp 
spring.servlet.multipart .max-file-size=1MB 
spring.servlet.multipart .max-request-size=10MB 
spring.servlet.multipart.resolve-lazily=false 


ao wm 





代码 解释 : 

@ 第 1 行 表示 是 否 开启 文件 上 传 支持 ， 默 认为 tue。 

@ 第 2 行 表示 文件 写 入 磁盘 的 阅 值 ， 默 认为 0。 

@ 第 3 行 表示 上 传 文件 的 临时 保存 位 置 。 

@ 第 4 行 表 示 上 传 的 单个 文件 的 最 大 大 小 ， 默 认为 1MB。 
e@ 第 5 行 表示 多 文件 上 传 时 文件 的 总 大 小 ， 默 认为 10MB。 
@ 第 6 行 表示 文件 是 否 延迟 解析 ， 默 认为 false。 


4.3.2 ”多 文件 上 传 


多 文件 上 传 和 单 文件 上 传 基本 一 致 ， 首 先 修改 HIML 文件 ， 代 码 如 下 : 
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<!DOCTYPE html> 

<html lang="en"> 
<head> 

<meta charset="UTF-8"> 
<title>Title</title> 
</head> 


<body> 

<form action="/uploads" method="post" enctype="multipart/form-data"> 
<input type="file" name="uploadFiles" value=" 请 选择 文件 " multiple> 
<input type="submit" value=" 上 传 "> 

</form> 

</body> 

</html> 


PPPoA 
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然后 修改 控制 器 ， 代 码 如 下 : 


Q@PostMapping ("/uploads") 
public String upload (MultipartFile[] uploadFiles, HttpServletRequest req) { 
// 遍 历 uploadFiles 数组 分 别 存储 








AODP 





} 
控制 器 里 边 的 核心 逻辑 和 单 文件 上 传 是 一 样 的 ， 只 是 多 一 个 遍历 的 步骤 。 


4.4 @ControllerAdvice 


顾名思义 ，@ControllerAdvice 就 是 @Controller 的 增强 版 。@ControllerAdvice 主要 用 来 处 理 全 
局 数据 ， 一 般 搭 配 @ExceptionHandler、@ModelAttribute 以 及 @InitBinder 使 用 。 


4.4.1 全 局 异常 处 理 


@ControllerAdvice 最 常见 的 使 用 场景 就 是 全 局 异常 处 理 。 在 4.3 节 向 读者 介绍 过 文件 上 传 大 
小 限制 的 配置 ， 如 果 用 户 上 传 的 文件 超过 了 限制 大 小 ， 就 会 抛 出 异常 ， 此 时 可 以 通过 
@ControllerAdvice 结合 @ExceptionHandler 定义 全 局 异常 捕获 机 制 ， 代 码 如 下 : 


Q@ControllerAdvice 
public class CustomExceptionHandler { 
QExceptionHandler (MaxUploadSizeExceededException.class) 
public void uploadException (MaxUploadSizeExceededException e, 
HttpServletResponse resp) throws IOException { 
resp.setContentType ("text/html;charset=utf-8"); 
PrintWriter out = resp.getWriter(); 
out .write ("上 传 文件 大 小 超出 限制 1") ; 
out.flush(); 
10 out.close(); 
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只 需 在 系统 中 定义 CustomExceptionHandler 类 ， 然 后 添加 @ControllerAdvice 注解 即 可 。 当 系 
统 启动 时 ， 该 类 就 会 被 扫描 到 Spring 容器 中 ， 然 后 定义 uploadException 方法 ， 在 该 方法 上 添加 了 
@ExceptionHandler 注解 ， 其 中 定义 的 MaxUploadSizeExceededException.class 表明 该 方法 用 来 处 理 
MaxUploadSizeExceededException 类 型 的 异常 。 如 果 想 让 该 方法 处 理 所 有 类 型 的 异常 ， 只 需 将 
MaxUploadSizeExceededException 改 为 Exception 即 可 。 方 法 的 参数 可 以 有 异常 实例 、 
HttpServletResponse 以 及 HttpServletRequest、Model 等 ， 返 回 值 可 以 是 一 段 JSNON 、 一 个 
ModelAndView、 一 个 逻辑 视图 名 等 。 此 时 ， 上 传 一 个 超大 文件 会 有 错误 提示 给 用 户 ， 如 图 4-8 所 
不 。 


ye localhost:8080/upload x \ 


各 C 个 © localhost:8080/upload 


上 传 文件 大 小 超出 限制 ! 


图 4-8 





如 果 返 回 参数 是 一 个 ModelAndView, 假设 使 用 的 页 面 模板 为 Thymeleaf (注意 添加 Thymeleaf 
相关 依赖 ) ， 此 时 异常 处 理 方法 定义 如 下 : 


@ControllerAdvice 
public class CustomExceptionHandler { 
QExceptionHandler (MaxUploadSizeExceededException.class) 
public ModelAndView uploadException (MaxUploadSizeExceededException e) throws 
IOException { 
ModelAndView mv = new ModelAndView(); 
mv.addOobject ("msg"，" 上 传 文件 大 小 超出 限制 1") ; 
mv.setViewName ("error"); 
return mv; 


Fomnammmwmn 











然后 在 resources/templates 目录 下 创建 error.html 文件 ， 内 容 如 下 : 


<!DOCTYPE html> 

<html lang="en" xmlns:th="http://www.thymeleaf.org"> 
<head> 

<meta charset="UTF-8"> 

<title>Title</title> 

</head> 

<body> 

<div th:text="$ {msg}"></div> 

</body> 

</html> 
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此 时 上 传 出 错 效果 与 图 4-8 一 致 。 
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4.4.2 添加 全 局 数据 


@ControllerAdvice 是 一 个 全 局 数据 处 理 组 件 ， 因 此 也 可 以 在 @ControllerAdvice 中 配置 全 局 数 
据 ， 使 用 @ModelAttribute 注解 进行 配置 ， 代 码 如 下 : 


@ControllerAdvice 

public class GlobalConfig { 
@ModelAttribute (value = "info") 
public Map<String, String> userInfo() { 











HashMap<String, String> map = new HashMap<>(); 
map.put ("username", "罗贯中 ") ; 

map.put ("gender", "ys 

return map; 








POAoDLp 





代码 解释 : 

@ 在 全 局 配置 中 添加 userInfo 方法 ， 返 回 一 个 map。 该 方法 有 一 个 注解 @ModelAttribute， 其 中 
的 value 属性 表示 这 条 返回 数据 的 key， 而 方法 的 返回 值 是 返回 数据 的 value。 

e ”此 时 在 任意 请 求 的 Controller 中 ， 通 过 方法 参数 中 的 Model 都 可 以 获取 info 的 数据 。 


Controller 示例 代码 如 下 : 


@GetMapping ("/hello") 
@ResponseBody 
public void hello(Model model) { 
Map<String, Object> map = model.asMap(); 
Set<String> keySet = map.keySet (); 
Iterator<String> iterator = keySet.iterator(); 
while (iterator.hasNext()) { 
String key = iterator.next(); 
Object value = map.get (key); 
System.out .println(key + ">>>>>" + value); 


Fenammmwmn 
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，username= 轩 贯 中 } 


图 4-9 





4.4.3 ”请求 参 数 预 处理 


@ControllerAdvice 结合 @InitBinder 还 能 实现 请 求 参 数 预 处 理 ， 即 将 表单 中 的 数据 绑 定 到 实体 
类 上 时 进行 一 些 额外 处 理 。 
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例如 有 两 个 实体 类 Book 和 Author， 代 码 如 下 : 


public class Book { 
Private String name; 
private String author; 
// 省 略 getter/setter 





} 

public class Author { 
private String name; 
private int age; 
// 省 略 getter/setter 


cmwm 








es 
So 


3} 
在 Controller 上 需要 接收 两 个 实体 类 的 数据 ，Controller 中 的 方法 定义 如 下 : 








Q@GetMapping ("/book") 
Q@ResponseBody 
public String book (Book book,Author author) { 
return book.toString() + ">>>" + author.toString(); 








on 必 w 


} 


此 时 在 参数 传递 时 ， 两 个 实体 类 中 的 name 属性 会 混淆 ，@ControllerAdvice 结合 @InitBinder 
可 以 顺利 解决 该 问题 。 配 置 步 又 如 下 。 
首先 给 Controller 中 方法 的 参数 添加 @ModelAttribute 注解 ， 代 码 如 下 : 
Q@GetMapping ("/book") 
Q@ResponseBody 
public String book (@ModelAttribute("b") Book book, @ModelAttribute("a") Author 


author) { 
return book.toString() + ">>>" + author.toString(); 








} 
然后 配置 @ControllerAdvice， 代 码 如 下 : 


1 Q@ControllerAdvice 

4 public class GlobalConfig { 

3 @InitBinder ("b") 

4 public void init (WebDataBinder binder) { 
5 binder.setFieldDefaultPrefix("b."); 

6 } 

对 @InitBinder ("a") 

8 public void init2 (WebDataBinder binder) { 
9 binder.setFieldDefaultPrefix("a."); 

10 } 











代码 解释 : 

e 在 GlobalConfig 类 中 创建 两 个 方法 ， 第 一 个 @InitBinder("b") 表 示 该 方法 是 处 理 
@ModelAttibute("b") 对 应 的 参数 的 ， 第 二 个 @InitBinder("a") 表 示 该 方法 是 处 理 
@ModelAttribute("a") 对 应 的 参数 的 。 
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e 在 每 个 方法 中 给 相应 的 Field 设置 一 个 前 缓 ， 然 后 在 浏览 器 中 请 求 
http:Wlocalhost8080/book?b name= 三 国 演义 &b author 罗贯中 &aname= 曹 雪 芹 &aage=48， 即 
可 成 功 地 区 分 出 name 属性 。 

e 在 WebDataBinder 对 象 中 ， 还 可 以 设置 允许 的 字段 、 禁 止 的 字段 、 必 填 字段 以 及 验证 器 等 。 


4.5 ” 自 定义 错误 页 


4.4 节 向 读者 介绍 了 Spring Boot 中 的 全 局 异常 处 理 。 在 处 理 异 常 时 , 开发 者 可 以 根据 实际 情况 
返回 不 同 的 页 面 , 但 是 这 种 异常 处 理 方式 一 般 用 来 处 理应 用 级 别 的 异常 , 有 一 些 容器 级 别 的 错误 就 
处 理 不 了 ， 例 如 Filter 中 抛 出 异常 ， 使 用 @ControllerAdvice 定义 的 全 局 异常 处 理 机 制 就 无 法 处 理 。 
因此 ，Spring Boot 中 对 于 异常 的 处 理 还 有 另外 的 方式 ， 这 就 是 本 节 要 介绍 的 内 容 。 

在 Spring Boot 中 ， 默 认 情况 下 ， 如 果 用 户 在 发 起 请 求 时 发 生 了 404 错误 ，Spring Boot 会 有 一 
个 默认 的 页 面 展 示 给 用 户 ， 如 图 4-10 所 示 。 

el localhosta080/hello7” x 
€ GO © Ilocalhost8080/hello777 





Whitelabel Error Page 


This application has no explicit mapping for /error, so you are seeing this as a fallback. 


Wed Jul 11 14:28:05 CST 2018 
There was an unexpected error (type=Not Found, status=404). 
No message available 





图 4-10 
如 果 发 起 请 求 时 发 生 了 500 错误 ，Spring Boot 也 会 有 一 个 默认 的 页 面 展 示 给 用 户 ， 如 图 4-11 
所 示 。 
localhost:s080/hello xx 也 


各 CO © localhost:8080/hello 


Whitelabel Error Page 


This application has no explicit mapping for /error, so you are seeing this as a fallback. 


Wed Jul 11 14:29:31 CST 2018 
There was an unexpected error (type=Internal Server Error, status=500). 
/by zero 





图 4-11 





事实 上 , Spring Boot 在 返回 错误 信息 时 不 一 定 返 回 HTML 页 面 , 而 是 根据 实际 情况 返回 HIML 
页 面 或 者 一 段 JSON ( 若 开发 者 发 起 Ajax 请 求 ， 则 错误 信息 是 一 段 JSON) 。 对 于 开发 者 而 言 ， 这 
一 段 HTML 或 者 JSON 都 能 够 自由 定制 。 

Spring Boot 中 的 错误 默认 是 由 BasicErorController 类 来 处 理 的 ， 该 类 中 的 核心 方法 主要 有 两 个 : 
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1 @RequestMapping (produces = "text/html") 

区 public ModelAndView errorHtml] (HttpServletRequest request， 

3 HttpServletResponse response) { 

4 HttpStatus status = getStatus (request); 

5 Map<String, Object> model = Collections.unmodifiableMap (getErrorAttributes( 

6 request, isIncludeStackTrace (request, MediaType.TEXT HTML))); 

2 response.setStatus (status.value ()); 

8 ModelAndView modelAndView = resolveErrorView (request, response, status, model); 
9 return (modelAndView != null ? modelAndView : new ModelAndView ("error", model)); 
10 | } 


11 | @RequestMapping 
12 | @ResponseBody 
13 | public ResponseEntity<Map<String, Object>> error(HttpServletRequest request) { 


14 Map<String, Object> body = getErrorAttributes (request, 
15 isIncludeStackTrace (request, MediaType.ALL)); 

16 HttpStatus status = getStatus (request); 

17 return new ResponseEntity<> (body, status); 











其 中 ,errorHtml 方 法 用 来 返回 错误 HTML 页 面 ,error 用 来 返回 错误 JSON, 具体 返回 的 是 HTML 
还 是 JSON， 则 要 看 请 求 头 的 Accept 参数 。 返回 JSON 的 逻辑 很 简单 ， 不 必 过 多 介绍 ， 返 回 HTML 
的 逻辑 稍微 有 些 复 杂 ， 在 errorHtml 方法 中 ， 通 过 调用 resolveErrorView 方法 来 获取 一 个 错误 视图 
的 ModelAndView。 而 resolveErrorView 方法 的 调用 最 终 会 来 到 DefaultErrorViewResolver 类 中 。 

DefaultErorViewResolver 类 是 Spring Boot 中 默认 的 错误 信息 视图 解析 器 ， 部 分 源码 如 下 : 


1 |public class DefaultErrorViewResolver implements ErrorViewResolver, Ordered { 
2 private static final Map<Series, String> SERIES VIEWS; 

3 static { 

4 Map<Series, String> views = new EnumMap<> (Series.class); 

5 Views.put (Series.CLIENT ERROR, "4xx"); 

6 Views.put (Series.SERVER ERROR, "5xx"); 

于 SERIES_VIEWS = Collections.unmodifiableMap (views); 

8 } 

9 

10 本 

11 | private ModelAndView resolve (String viewName, Map<String, Object> model) { 
12 String errorViewName = "error/" + viewName; 

13 TemplateAvailabilityProvider provider = this.templateAvailabilityProviders 
14 .getProvider (errorViewName, this.applicationContext); 

3 if (provider != null) { 

16 return new ModelAndView (errorViewName, model); 

17 } 

18 return resolveResource (errorViewName, model); 

19 | 

20 











从 这 一 段 源码 中 可 以 看 到 ，Spring Boot 默认 是 在 error 目录 下 查找 4xx、5xx 的 文件 作为 错误 
视图 ， 当 找 不 到 时 会 回 到 errorHtml 方法 中 ,然后 使 用 error 作为 默认 的 错误 页 面 视图 名 ， 如果 名 为 
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error 的 视图 也 找 不 到 ， 用 户 就 会 看 到 本 节 一 开始 展示 的 两 个 错误 提示 页 面 。 整 个 错误 处 理 流 程 大 
致 就 是 这 样 的 。 





4.5.1 简单 配置 


通过 上 面 的 介绍 ， 读 者 可 能 已 经 发 现 ， 要 自 定 义 错误 页 面 其 实 很 简单 ， 提 供 4xx 和 Sxx 页 面 
即 可 。 如 果 开 发 者 不 需要 向 用 户 展示 详细 的 错误 信息 ， 那 么 可 以 把 错误 信息 定义 成 静态 页 面 ， 直接 
在 resources/static 目录 下 创建 error 目录 ， 然 后 在 error 目录 中 创建 错误 展示 页 面 。 错 误 展示 页 面 的 
命名 规则 有 两 种 : 一 种 是 4xx.html、5xx.html; 另 一 种 是 直接 使 用 响应 码 命 名 文件 ， 例 如 404.html、 
405.html、500.html。 第 二 种 命名 方式 划分 得 更 细 ， 当 出 错时 ， 不 同 的 错误 会 展示 不 同 的 错误 页 面 ， 
如 图 4-12 所 示 。 





src 
main 
Ml java 
三 resources 
static 
error 
局 404.html 
总 500.html 
templates 
og®@ application.properties 
test 
图 4-12 
此 时 ， 当 用 户 访问 一 个 不 存在 的 路 径 时 ， 就 会 展示 404.html 页 面 中 的 内 容 ， 如 图 4-13 所 示 。 
J Title x \WA 


€ GC 全 | © localhost:8080/aaa 





404 





图 4-13 


修改 Controller， 提 供 一 个 会 抛 异常 的 请 求 ， 代 码 如 下 : 


@RestController 
public class HelloController { 
@GetMapping ("/hello" 
public String hello() { 
int i =1/0; 
return "hello"; 





ao 性 
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时 } 
8 | } 











访问 该 接口 ， 就 会 展示 500.html 中 的 内 容 ， 如 图 4-14 所 示 。 





一 Title X 


中 GCG 合 | © localhost:8 


500 





图 4-14 


这 种 定义 都 是 使 用 了 静态 HTML 页 面 ， 无 法 向 用 户 展示 完整 的 错误 信息 ， 若 采用 视图 模板 技 
术 ， 则 可 以 向 用 户 展示 更 多 的 错误 信息 。 如 果 要 使 用 HTML 模板 ， 那 么 先 引入 模板 相关 的 依赖 ， 


这 里 以 Thymeleaf 为 例 , Thymeleaf 页 面 模板 默认 处 于 classpath:/templates/ 目 录 下, 因 





先 创建 error 目录 ， 再 创建 错误 展示 页 ， 如 图 4-15 所 示 。 
src 
main 
Ml java 
resources 
static 
templates 
error 
局 4ochtml 
避 5ochtml 
Hl errorPage.html 


喝 application.properties 








test 


图 4-15 


此 在 该 目录 下 


由 于 模板 页 面 展 示 信 息 比 较 灵活 ， 因 此 可 以 直接 创建 4xx.html、5xx.html。 以 4xx.html 页 面 为 


例 ， 其 内 容 如 下 : 


<!DOCTYPE html> 

<html lang="en" xmlns:th="http://www.thymeleaf.org/"> 
<head> 

<meta charset="UTF-8"> 
<title>Title</title> 

</head> 

<body> 

<table border="1"> 

<tr> 

<td>timestamp</td> 

<td th:text="${timestamp}"></td> 





FFPDocDamwm 必 wm 
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12 | </tr> 

13 | <tr> 

14 | <td>status</td> 

15 | <td th:text="${status}"></td> 
6 | /trey> 

LT | tL 

18 | <td>error</td> 
19 | <td th:text="$ {error}"></td> 
20 | </tr> 
21 | <tr> 
22 | <td>message</td> 
23 | <td th:text="$ {message}"></td> 
24 | </tr> 

25 | <tr> 

26 | <td>path</td> 
27 | <td th:text="${path}"></td> 











28 | </tr> 

29 | </table> 
30 | </body> 
31 | </html> 





Spring Boot 在 这 里 一 共 返 回 了 5 条 错误 相关 的 信息 , 分 别 是 timestamp、status、error、message 
以 及 path。5xx.html 页 面 的 内 容 与 4xx.html 页 面 的 内 容 一 致 。 
此 时 ， 用 户 访问 一 个 不 存在 的 地 址 ，4xx.html 页 面 中 的 内 容 将 被 展示 出 来 ， 如 图 4-16 所 示 。 


We C OO |© localhost80 








timestampllWed Jul 11 17:43:57 CST 2018 
status 1404 

error Not Found _ 

message |INo message available 

path aaa 



























































图 4-16 


车 用 户 访 问 一 个 会 抛 异常 的 地 址 ， 例 如 上 文 的 /hello 接口 ， 则 会 展示 5xx.html 页 面 的 内 容 ， 如 
4-17 所 示 。 
Va Title x Ne 


€ GC 合 | © localhost:8080/hello 














timestampllWed Jul 11 17:45:49 CST 2018| 


status |500 | 
| 








error lInternal Server Error 








message /by zero 
path hello 


























图 4-17 
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若 用 户 定义 了 多 个 错误 页 面 ， 则 响应 码 .html 页 面 的 优先 级 高 于 4xx.html、5xx.html 页 面 的 
优先 级 ， 即 若 当 前 是 一 个 404 错误 ， 则 优先 展示 404.html 而 不 是 4xxhtml; 动态 页 面 的 优先 
级 高 于 静态 页 面 ， 即 若 resources/templates 和 resources/static 下 同时 定义 了 4xxhtml， 则 优先 


展示 resources/templates/4xx.html。 





4.5.2 ”复杂 配置 


上 面 这 种 配置 还 是 不 够 灵活 ， 只 能 定义 HTML 页 面 ， 无 法 处 理 JSON 的 定制 。Spring Boot 中 
支持 对 Error 信息 的 深度 定制 , 接 下 来 将 从 三 个 方面 介绍 深度 定制 : 自 定义 Error 数据 、 自 定义 Error 
视图 以 及 完全 自 定义 。 

1. 自 定 义 Error 数据 

自 定义 Eror 数据 就 是 对 返回 的 数据 进行 自 定义 。 经 过 4.5.1 小 节 的 介绍 ， 读 者 已 经 了 解 到 
Spring Boot 返回 的 Error 信息 一 共有 5 条， 分 别 是 timestamp、status、error、message 以 及 path。 在 
BasicErrorController 的 errorHtml 方法 和 error 方法 中 ， 都 是 通过 getErrorAttributes 方法 获取 Error 
信息 的 。 该 方法 最 终 会 调用 到 DefaultErrorAttributes 类 的 getEmrorAttributes 方法 ， 而 
DefaultErrorAttributes 类 是 在 ErorMvcAutoConfiguration 中 默认 提供 的 。ErrorMvcAutoConfiguration 
类 的 errorAttributes 方法 源码 如 下 : 

Q@Bean 


Q@ConditionalOnMissingBean (value = ErrorAttributes.class, search = 
SearchStrategy .CURRENT) 


public DefaultErrorAttributes errorAttributes() { 
return new DefaultErrorAttributes( 
this.serverProperties.getError() .isIncludeException()); 





从 这 段 源码 中 可 以 看 出 ， 当 系统 没有 提供 ErrorAttributes 时 才 会 采用 DefaultErrorAttributes。 
因此 自 定 义 错 误 提示 时 ， 只 需要 自己 提供 一 个 ErrorAttributes 即 可 ， 而 DefaultErrorAttributes 是 
ErrorAttributes 的 子 类 ， 因 此 只 需要 继承 DefaultErrorAttributes 即 可 ， 代 码 如 下 : 





1 @Component 

x public class MyErrorAttribute extends DefaultErrorAttributes{ 

3 QOverride 

4 public Map<String，Object> getErrorAttributes (WebRequest webRequest，boolean 
5 includeStackTrace) { 

6 Map<String，Object> errorAttributes = super.getErrorAttributes (webRequest, 
时 includeStackTrace); 

8 errorAttributes.put ("custommsg"，" 出 错 啦 ! "); 

9 errorAttributes.remove ("error"); 

10 return errorAttributes; 

11 } 

1 
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代码 解释 : 

@ 自 定 义 MyEmorAttribute 继承 自 DefaultErorAttributes， 重 写 DefaultErorAttributes 中 的 
getErrorAttributes 方法 。MyErorAttribute 类 添加 @Component 注解 ， 该 类 将 被 注册 到 Spring 
容器 中 。 

@ 第 6、7 行 通过 super.getErorAttributes 获取 Spring Boot 默认 提供 的 错误 信息 ， 然 后 在 此 基础 
上 添加 Error 信息 或 者 移 除 Error 信息 。 


此 时 ， 当 系统 抛 出 异常 时 ， 错 误 信息 将 被 修改 ， 以 4.5.1 节 中 的 动态 页 面 模板 404.html 为 例 ， 


修改 404.html， 代 码 如 下 : 





camwmmwm 


<!DOCTYPE html> 

<html lang="en" xmlns:th="http://www.thymeleaf.org/"> 
<head> 

<meta charset="UTF-8"> 

<title>Title</title> 

</head> 

<body> 

<table border="1"> 

<tr> 

<td>custommsg</td> 

<td th:text="$ {custommsg}"></td> 

</tr> 
<tr> 
<td>timestamp</td> 

<td th:text="$ {timestamp}"></td> 
</tr> 
<tr> 
<td>status</td> 
<td th:text="${status}"></td> 
</tr> 

<tr> 
<td>error</td> 
<td th:text="$ {error}"></td> 
</tr> 
<tr> 
<td>message</td> 
<td th:text="$ {message}"></td> 
</tr> 

<tr> 
<td>path</td> 
<td th:text="$ {path}"></td> 
</tr> 

</table> 

</body> 

</html> 











在 第 9~12 行 添加 了 custommsg 属性 ， 此 时 访问 一 个 不 存在 的 路 径 ， 就 能 看 到 自 定义 的 Error 


信息 ， 并 且 可 以 看 到 默认 的 error 被 移 除了 ， 如 图 4-18 所 示 。 
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不 。 


€ GC © | © localhost:8080/aaa 


J ed Title x 








custommsgj| 出 错 啦 ! 

timestamp ||Wed Jul 11 23:47:34 CST 2018 
status 1404 

lerror | 


























message ||INo message available 
path aaa 



































图 4-18 


如 果 通 过 Postman 等 工具 来 发 起 这 个 请 求 ， 那 么 返回 的 JSON 数据 中 也 是 如 此 ， 如 图 4-19 所 


一 一 
GET hrtp://localhosc8080/aaa 


Authorization 


Body 3) 





BE 


"timestamp": "2018-87-11T15:53:01.834+0800", 
"status": 404， 

"message": "No message available", 

"path": "/aaa”, 

"custommsg": "出 错 啦 ! " 














图 4-19 


2. 自 定义 Error 视图 
Eror 视图 是 展示 给 用 户 的 页 面 ， 在 BasicErorController 的 errorHtml 方法 中 调用 


resolveErrorView 方法 获取 一 个 ModelAndView 实例 。resolveErrorView 方法 是 由 ErrorViewResolver 
提供 的 ， 通 过 ErrorMveAutoConfiguration 类 的 源码 可 以 看 到 Spring Boot 默认 采用 的 
ErrorViewResolver 是 DefaultErrorViewResolver。ErorMvcAutoConfiguration 部 分 源码 如 下 : 








own 


Bean 
@ConditionalOnBean (DispatcherServlet.class) 
econditionalOnMissingBean 
public DefaultErrorViewResolver conventionErrorViewResolver() { 
return new DefaultErrorViewResolver (this.applicationContext, 
this.resourceProperties); 
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error 目录 下 寻找 4xx.html、5xx.html。 因 


从 这 一 段 源码 可 以 看 到 ， 如 果 用 户 没 有 定义 ErorViewResolver， 那 么 默认 使 用 的 
ErrorViewResolver 是 DefaultErrorViewResolver， 正 是 在 DefaultErrorViewResolver 中 配置 了 默认 去 





ErrorViewResolver 即 可 ， 代 码 如 下 : 


Feiawmwm 





oamwmmwmn 哺 








@Component 
public class MyErrorViewResolver 
QOverride 


public ModelAndView resolveErrorView (HttpServletRequest request, Httpstatus 


status, Map<String, Object> mode 


ModelAndView mv = new ModelAndView ("errorPage"); 


mv.addObject ("custommsg", 
mv.addAllObjects (model); 
return mV7 


代码 解释 : 


此 ， 开 发 者 想 要 自 定义 Error 视图 ， 只 需要 提供 自己 的 


implements ErrorViewResolver { 


14 


"出 错 啦 !1 ") 7 





ee 自 定义 MyErrorViewResolver 实现 ErrorViewResolver 接 口 并 实现 接口 中 的 resolveErrorView 方 


法 ， 使 用 @Component 注解 将 该 类 ; 


注册 到 Spring 容器 中 。 


@ 在 resolveErrorView 方法 中 ， 最 后 一 个 Map 参数 就 是 Spring Boot 提供 的 默认 的 5 条 Error 信 
息 (可 以 按照 前 面 自 定义 Error 数据 的 步骤 对 这 5 条 消息 进行 修改 )。 在 resolveErrorView 方 
法 中 ， 返 回 一 个 ModelAndView， 在 ModelAndView 中 设置 Error 视图 和 Error 数据 。 

@ ”理论 上 ， 开 发 者 也 可 以 通过 实现 ErrorViewResolver 接口 来 实现 Error 数据 的 自 定义 ， 但 是 如 


果 只 是 单纯 地 想 自 定义 Error 数据 ， 


还 是 建议 继承 DefaultErrorAttributes。 


接 下 来 在 resources/templates 目录 下 提供 errorPage.html 视图 ， 内 容 如 下 : 





<!DOCTYPE html> 

<html lang="en" xmlns:th="http:/ 
<head> 

<meta charset="UTF-8"> 
<title>Title</title> 

</head> 

<body> 

<h3>errorPage</h3> 

<table border="1"> 

<tr> 

<td>custommsg</td> 

<td th:text="${custommsg}"></td> 
</tr> 

<tr> 

<td>timestamp</td> 

<td th:text="$ {timestamp}"></td> 
</tr> 

<tr> 

<td>status</td> 

<td th:text="${status}"></td> 


/www.thymeleaf.org/"> 
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21 | </tr> 

2 | <tr 

23 | <td>error</td> 

24 | <td th:text="$ {error}"></td> 
25 [</tr> 

26 | <tr> 

27 | <td>message</td> 

28 | <td th:text="$ {message}"></td> 
29 | </tr> 

30 | <tr> 

31 | <tq>path</td> 

32 | <td th:text="$ {path}"></td> 








33 | </tr> 

34 | </table> 
35 | </body> 
36 | </html> 





在 errorPage.html 中 ， 除 了 展示 Spring Boot 提供 的 5 条 Error 信息 外 ， 也 展示 了 开发 者 自 定义 
的 Error 信息 。 此 时 ， 无 论 请 求 发 生 4xx 的 错误 (如 图 4-20 所 示 ) 还 是 发 生 5xx 的 错误 (如 图 4-21 
所 示 ) ， 都 会 来 到 errorPage.html 页 面 。 
J 加 Tue x\W 
所 GC 合 | © localhost80 





ei Te x\ 


€ GC OO © localhost8 




















































































































errorPage errorPage 
custommsg| 出 错 啦 ! ! |custommsg| 出 错 啦 ! ! 
ltimestamp IThu Jul 12 08:19:02 CST 2018 timestamp |[Thu Jul 12 08:19:30 CST 2018| 
status 404 [status jls00 
Eo NotFound _ J error Internal Server Error 
message “|INo message available |message jbyzero 
path /aaa llpath /hello 
图 4-20 图 4-21 
3. 完全 自 定义 














前 面 提 到 的 两 种 自 定 义 方式 都 是 对 BasicErrorController 类 中 的 某 个 环节 进行 修补 。 查 看 Error 
自动 化 配置 类 ErrorMvcAutoConfiguration, 读者 可 以 发 现 BasicErrorController 本 身 只 是 一 个 默认 的 
配置 ， 相 关 源 码 如 下 : 





public class ErrorMvcAutoConfiguration { 


Bean 


SearchStrategy.CURRENT) 
public BasicErrorController basicErrorController (ErrorAttributes errorAttributes) { 
return new BasicErrorController (errorAttributes, 





下 
2 
3 
4 
入 @ConditionalOnMissingBean (value = ErrorController.class, search = 
6 
7 
8 
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9 this.serverProperties.getError(), 
10 | this.errorViewResolvers); 








Fy 
2 

二 外 志 
14 | } 





从 这 段 源 码 中 可 以 看 到 ， 若 开发 者 没有 提供 自己 的 ErrorController， 则 Spring Boot 提供 
BasicErrorController 作为 默认 的 ErrorController。 因 此 ， 如 果 开 发 者 需要 更 加 灵活 地 对 Error 视图 和 
数据 进行 处 理 ， 那 么 只 需要 提供 自己 的 ErrorController 即 可 。 提 供 自己 的 ErrorController 有 两 种 方 
式 : 一 种 是 实现 ErrorController 接口 ， 另 一 种 是 直接 继承 BasicErrorController。 由 于 ErrorController 
接口 只 提供 一 个 待 实现 的 方法 , 而 BasicErrorController 已 经 实现 了 很 多 功能 , 因此 这 里 选择 第 二 种 
方式 ， 即 通过 继承 BasicErrorController 来 实现 自己 的 ErrorController。 具 体 定义 如 下 : 











下 @Controller 

2 public class MyErrorController extends BasicErrorController { 

EE @Autowired 

4 public MyErrorController (ErrorAttributes errorAttributes, 

5 ServerProperties serverProperties, 

6 List<ErrorViewResolver> errorViewResolvers) { 

等 super (errorAttributes, serverProperties.getError(), errorViewResolvers); 
8 } 

9 QOverride 

0 public ModelAndView errorHtml (HttpServletRequest request, 

1 HttpServletResponse response) { 

HttpStatus status = getStatus (request); 

3 Map<String, Object> model = getErrorAttributes( 

4 request, isIncludeStackTrace (request, MediaType.TEXT HTML)); 
5 model .put ("custommsg"， "出 错 啦 ! ") ; 

6 ModelAndView modelAndView = 

7 | new ModelAndView ("myErrorPage", model, status); 

8 return modelAndView; 

9 } 

20 QOverride 

21 public ResponseEntity<Map<String, Object>> error(HttpServletRequest request) { 
22 Map<String，Object> body = getErrorAttributes (request, 

23 isIncludeStackTrace (request, MediaType.ALL)); 

24 body.put ("custommsg"，" 出 错 啦 ! ") ; 

25 HttpStatus status = getStatus (request); 

26 return new ResponseEntity<> (body, status); 

27 } 

28 |} 








代码 解释 : 

ee 自 定义 MyErorController 继承 自 BasicErorController 并 添加 (@Controller 注解 ， 将 
MyErrorController 注册 到 Spring MVC 容器 中 。 

@ ”由 于 BasicErrorController 没有 无 参 构 造 方法 ， 因 此 在 创建 BasicErrorController 实例 时 需要 传 
递 参数 ， 在 MyErrorController 的 构造 方法 上 添加 (@Autowired 注解 注入 所 需 参 数 。 
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@ 参考 BasicErrorController 中 的 实现 , 重 写 errorHtml 和 error 方法 , 对 Error 的 视图 和 数据 进行 


充分 的 自 定义 。 


最 后 ， 在 resources/templates 目录 下 提供 myErrorPage.html 页 面 作为 视图 页 面 ， 代 码 如 下 : 











oo Dp 


> 户 
[= 


<!DOCTYPE html> 

<html lang="en" xmlns:th="http://www.thymeleaf.org/"> 
<head> 

<meta charset="UTF-8"> 

<title>Title</title> 

</head> 

<body> 

<h3>myErrorPage</h3> 

<table border="1"> 

<tr> 

<td>custommsg</td> 

<td th:text="${custommsg}"></td> 

</tr> 
<tr> 
<td>timestamp</td> 

<td th:text="$ {timestamp}"></td> 
</tr> 
<tr> 
<td>status</td> 
<td th:text="${status}"></td> 
</tr> 

<tr> 
<td>error</td> 
<td th:text="$ {error}"></td> 
</tr> 
<tr> 
<td>message</td> 
<td th:text="$ {message}"></td> 
</tr> 

<tr> 
<td>path</td> 
<td th:text="$ {path}"></td> 
</tr> 

</table> 

</body> 

</html> 











访问 一 个 不 存在 的 页 面 ， 就 可 以 看 到 自 定义 的 错误 提示 了 ， 如 图 





4-22 所 示 。 
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C 合 | © localhost:8080/aaaa 


myErrorPage 








[custommsg| 出 错 啦 ! 
timestamp |Thu Jul 12 11:54:45 CST 2018 
status |404 

lerror INot Found _ 
message [No message available 
path /aaaa 


















































图 4-22 
如 果 通 过 Postman 等 工具 发 起 这 个 请 求 ， 那 么 返回 数据 为 一 段 JISON， 如 图 4-23 所 示 。 
GET http://localhost:8080/aaaa| 


Authorization 


Type 


Body (G3) 
Prerty JSON E37 


"timestamp": "2018-87-12T83:52:35.944+9089", 
"status": 464， 






Found"， 
No message available", 








图 4-23 


Spring Boot 中 对 异常 的 处 理 还 是 非常 容易 的 ，Spring Boot 虽然 提供 了 非常 丰富 的 自动 化 配置 
方案 , 但 是 也 允许 开发 者 根据 实际 情况 进行 完全 的 自 定义 , 开发 者 在 使 用 过 程 中 可 以 结合 具体 情况 
选择 合适 的 Error 处 理 方案 。 


4.6 CORS 支持 


CORS (Cross-Origin Resource Sharing) 是 由 W3C 制定 的 一 种 跨 域 资源 共享 技术 标准 ， 其 目的 
就 是 为 了 解决 前 端的 跨 域 请 求 。 在 Java EE 开发 中 ,最 常见 的 前 端 跨 域 请 求解 决 方案 是 JSONP, 但 
是 JSONP 只 支持 GET 请 求 , 这 是 一 个 很 大 的 缺陷 , 而 CORS 则 支持 多 种 HITP 请 求 方法 ,以 CORS 
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中 的 GET 请 求 为 例 ， 当 浏览 器 发 起 请 求 时 ， 请 求 头 中 携带 了 如 下 信息 : 





Host: localhost:8080 
Origin: http://localhost:8081 
Referer: http://localhost:8081/index.html 


aowmn 











假如 服务 端 支持 CORS， 则 服务 端 给 出 的 响应 信息 如 下 : 





Access-Control-Allow-Origin: http://localhost:8081 
Content-Length: 20 

Content-Type: text/plain;charset=UTF-8 

Date: Thu, 12 Jul 2018 12:51:14 GMT 








oONMAOoODP 


响应 头 中 有 一 个 Access-Control-Allow-Origin 字段 ， 用 来 记录 可 以 访问 该 资源 的 域 。 当 浏览 
器 收 到 这 样 的 响应 头 信息 之 后 ， 提 取出 Access-Control-Allow-Origin 字段 中 的 值 ， 发 现 该 值 
包含 当前 页 面 所 在 的 域 ， 就 知道 这 个 跨 域 是 被 允许 的 ， 因 此 就 不 再 对 前 端的 跨 域 请 求 进行 


限制 。 这 就 是 GET 请 求 的 整个 跨 域 流程 ， 在 这 个 过 程 中 ， 前 端 请 求 的 代码 不 需要 修改 ， 主 
要 是 后 端 进行 处 理 。 这 个 流程 主要 是 针对 GET、POST 以 及 HEAD 请求， 并且 没 有 自 定 义 
请 求 头 ， 如 果 用 户 发 起 一 个 DELETE 请 求 、PUT 请 求 或 者 自 定 义 了 请 求 头 ， 流 程 就 会 稍微 
复杂 一 些 。 





以 DELETE 请 求 为 例 ， 当 前 端 发 起 一 个 DELETE 请 求 时 ， 这 个 请 求 的 处 理会 经 过 两 个 步骤 。 
第 一 步 : 发 送 一 个 OPTIONS 请 求 。 代 码 如 下 : 





Access-Control-Request-Method DELETE 
Connection keep-alive 

Host localhost:8080 

Origin http://localhost:8081 


camm 必 wm 





这 个 请 求 将 向 服务 端 询 问 是 否 具备 该 资源 的 DELETE 权限 ， 服 务 端 会 给 浏览 器 一 个 响应 ， 代 
码 如 下 : 
1 


发 we 
3 HTTP/1.1 200 
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4 |Access-Control-Allow-Origin: http://localhost:8081 
3 Access-Control-Allow-Methods: DELETE 

6 Access-Control-Max-Age: 1800 

7 |Allow: GET, HEAD, POST, PUT, DELETE, OPTIONS, PATCH 
8 Content-Length: 0 

9 Date: Thu, 12 Jul 2018 13:20:26 GMT 

10 

11 











服务 端 给 浏览 器 的 响应 ，Allow 头 信息 表示 服务 端 支持 的 请 求 方法 ， 这 个 请 求 相当 于 一 个 探测 
请 求 ， 当 浏览 器 分 析 了 请 求 头 字段 之 后 ， 知 道 服务 端 支持 本 次 请 求 ， 则 进入 第 二 步 。 
第 二 步 : 发 送 DELETE 请 求 。 接 下 来 浏览 器 就 会 发 送 一 个 跨 域 的 DELETE 请求， 代码 如 下 : 


Host: localhost:8080 
Origin: http://localhost:8081 
Connection: keep-alive 





amcwm 


服务 端 给 一 个 响应 : 


HTTP/1.1 200 

Access-Control-Allow-Origin: http://localhost:8081 
Content-Type: text/plain;charset=UTF-8 

Date: Thu, 12 Jul 2018 13:20:26 GMT 








onoODPDpp 





至 此 ， 一 个 跨 域 的 DELETE 请 求 完 成 。 

无 论 是 简单 请 求 还 是 需要 先进 行 探测 的 请 求 ， 前 端的 写法 都 是 不 变 的 ， 额 外 的 处 理 都 是 在 服 
务 端 来 完成 的 。 在 传统 的 Java EE 开发 中 ， 可 以 通过 过 滤器 统一 配置 ， 而 Spring Boot 中 对 此 则 提 
供 了 更 加 简洁 的 解决 方案 。 在 Spring Boot 中 配置 CORS 的 步骤 如 下 : 


1. 创建 Spring Boot 工程 
首先 创建 一 个 Spring Boot 工程 ， 添 加 Web 依赖 ， 代 码 如 下 : 


<dependency> 
<groupId>org. springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 








</dependency> 


2. 创建 控制 器 
在 新 创建 的 Spring Boot 工程 中 ， 添 加 -个 BookController 控制 器 ， 代 码 如 下 : 





时 @RestController 
@RequestMapping ("/book") 
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3 public class BookController { 
4 @PostMapping ("/") 
5 public String addBook (String name) { 
6 return "receive:" + name; 
7 } 

8 QDeleteMapping ("/{id}") 

9 public String deleteBookById(@PathVariable Long id) { 
10 return String.valueOf (id); 

1 } 








BookController 中 提供 了 两 个 接口 : 一 个 是 添加 接口 ， 另 一 个 是 删除 接口 。 
3. 配置 跨 域 
跨 域 有 两 个 地 方 可 以 配置 。 一 个 是 直接 在 相应 的 请 求 方法 上 加 注解 : 


QRestController 
@RequestMapping ("/book") 
public class BookController { 
@PostMapping ("/") 
@CrossOrigin(value = "http://localhost:8081" 
,maxAge = 1800,allowedHeaders = "*") 
public String addBook (String name) { 
return "receive:" + name; 


cammewm 


Re 


} 
@DeleteMapping ("/{id}") 
@CrossOrigin(value = "http://localhost:8081" 
,maxAge = 1800,allowedHeaders = "*") 
public String deleteBookById(@PathVariable Long id) { 
return String.valueOf (id); 


} 








PpppppPpp 
Aamo Po 


代码 解释 : 








@CrossOrigin 中 的 value 表示 支持 的 域 , 这 里 表示 来 自 http://localhost:8081 域 的 请 求 是 支持 跨 
域 的 。 

maxAge 表示 探测 请 求 的 有 效 期 ， 在 前 面 的 讲解 中 ， 读 者 已 经 了 解 到 对 于 DELETE、PUT 请 
求 或 者 有 自 定义 头 信息 的 请 求 , 在 执行 过 程 中 会 先 发 送 探 测 请 求 , 探测 请 求 不 用 每 次 都 发 送 ， 
可 以 配置 一 个 有 效 期 ， 有 效 期 过 了 之 后 才 会 发 送 探 测 请 求 。 这 个 属性 默认 是 1800 秒 ， 即 30 
分 钟 。 

allowedHeaders 表示 允许 的 请 求 头 ，* 表 示 所 有 的 请 求 头 都 被 允许 。 





这 种 配置 方式 是 一 种 细 粒 度 的 配置 ， 可 以 控制 到 每 一 个 方法 上 。 当 然 ， 也 可 以 不 在 每 个 方法 


上 添加 @CrossOrigin 注解 ， 而 是 采用 一 种 全 局 配置 ， 代 码 如 下 





1 @Configuration 
2 public class MyWebMvcConfig implements WebMvcConfigurer { 
3 QOverride 
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4 public void addCorsMappings (CorsRegistry registry) { 
5 registry.addMapping ("/book/**") 
6 .allowedHeaders ("*") 
E .allowedMethods ("*") 
8 .maxAge (1800) 
9 .allowedOrigins ("http://localhost:8081"); 
10 } 
11 1} 
代码 解释 : 


e@ 全 局 配置 需要 自 定 义 类 实现 WebMvcConfigurer 接口 ， 然 后 实现 接口 中 的 addCorsMappings 

e@ 在 addCorsMappings 方法 中 ，addMapping 表示 对 哪 种 格式 的 请 求 路 径 进 行 跨 域 处 理 ; 
allowedHeaders 表示 允许 的 请 求 头 ， 默 认 允 许 所 有 的 请 求 头 信息 ; allowedMethods 表示 允许 
的 请 求 方法 ， 默 认 是 GET、POST 和 HEAD; * 表 示 支 持 所 有 的 请 求 方法 ; maxAge 表示 探测 
请 求 的 有 效 期 ; allowedOrigins 表示 支持 的 域 。 


在 上 面 的 两 种 配置 方式 (@CrossOrigin 注解 配置 和 全 局 配置 ) 中 ， 选 择 其 中 一 种 即 可 ， 然 


后 启动 项 目 。 


4. 测试 
新 建 一 个 Spring Boot 项 目 ， 添 加 Web 依赖 ， 然 后 在 resources/static 目录 下 加 入 jqueryjs， 青 


在 resources/static 目录 下 创建 一 个 index.html 文件 ， 内 容 如 下 : 


虽 oomnam 必 wm 





<!DOCTYPE html> 
<html lang="en"> 
<head> 
<meta charset="UTF-8"> 
<title>Title</title> 
<script src="jquery3.3.1.js"></script> 
</head> 
<body> 
<div id="contentDiv"></div> 
<div id="deleteResult"></div> 
<input type="button" value=" 提 交 数 据 " onclick="getData()"><br> 
<input type="button" value=" 删 除数 据 " onclick="deleteData () "><br> 
<script> 
function deleteData() { 
$.ajax({ 
url: 'http://localhost:8080/book/99", 
type: 'delete', 
success:function (msg) { 
$ ("#deleteResult") .html (msg); 
} 
} 
} 
function getData() { 
$.ajax({ 
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55 url:'http://localhost:8080/book/', 
26 type: 'post", 

27 data: {name: ' 三 国 演义 '}， 

28 success:function (msg) { 

29 $ ("#contentDiv") .html (msg); 
30 } 

31 }) 

32 } 

33 | </script> 

34 | </body> 

35 | </html> 


两 个 普通 的 Ajax 都 发 送 了 一 个 跨 域 请 求 。 
然后 将 项 目的 端口 修改 为 8081， 代 码 如 下 : 


1 | server. port=8081 





启动 项 目 ， 在 浏览 器 中 输入 “http://localhost:8081/index.html”， 查 看 页 面 ， 然 后 分 别 单 击 两 个 
按钮 ， 查 看 请 求 结果 ， 如 图 4-24 所 示 。 


oi Title x 


GC 全 | © localhost:8081/index.html 


receive: 三 国 演义 





图 4-24 


4.7 配置 类 与 XML 配置 


Spring Boot 推荐 使 用 Java 来 完成 相关 的 配置 工作 。 在 项 目 中 ， 不 建议 将 所 有 的 配置 放 在 一 个 


配置 类 中 ， 


可 以 根据 不 同 的 需求 提供 不 同 的 配置 类 ， 例 如 专门 处 理 Spring Security 的 配置 类 、 提 供 


Bean 的 配置 类 、Spring MVC 相关 的 配置 类 。 这 些 配 置 类 上 都 需要 添加 @Configuration 注解 ， 
@ComponentScan 注解 会 扫描 所 有 的 Spring 组 件 ， 也 包括 @Configuration。@ComponentScan 注解 





在 项 目 入 











配置 类 即 可 





类 的 @Spring BootApplication 注解 中 已 经 提供 , 因此 在 实际 项 目 中 只 需要 按 需 提供 相关 


Spring Boot 中 并 不 推荐 使 用 XML 配置 , 建议 尽量 用 Java 配置 代替 XML 配置 , 本 书 中 的 案例 
都 是 以 Java 配置 为 主 。 如 果 开 发 者 需要 使 用 XML 配置 ， 只 需 在 resources 目录 下 提供 配置 文件 ， 
然后 通过 @ImportResource 加 载 配置 文件 即 可 。 例 如 ， 有 一 个 Hello 类 如 下 : 





和 public class Hello { 
2 public String sayHello(String name) { 
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3 return "hello " + name; 


-可 到 


在 resources 目录 下 新 建 beans.xml 文件 配置 该 类 : 











1 | <beans xmlns="http://www.springframework.org/schema/beans" 
2 xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
4 | http://www.springframework.org/schema/beans/spring-beans.xsd"> 
5 | <bean class="org.sang.Hello" id="hello"/> 
6 |</beans> 

然后 创建 Beans 配置 类 ， 导 入 XML 配置 : 

Q@Configuration 


@ImportResource ("classpath:beans.xml") 
public class Beans { 


} 
最 后 在 Controller 中 就 可 以 直接 导入 Hello 类 使 用 了 : 


Q@RestController 
public class HelloController { 
@Autowired 
Hello hello; 
@GetMapping ("/hello") 
public String hello() { 
return hello.sayHello ("江南 一 点 雨 "); 





} 











4.8 ”注册 拦截 器 


Spring MVC 中 提供 了 AOP 风格 的 拦截 器 ， 拥 有 更 加 精细 的 拦截 处 理 能 力 。Spring Boot 中 拦 
截 器 的 注册 更 加 方便 ， 步 骤 如 下 : 
步骤 01 A 创建 一 个 Spring Boot 项 目 ， 添 加 spring-boot-starter-web 依赖 。 
步骤 024 创建 拦截 器 实现 HandlerInterceptor 接口 ， 代 码 如 下 : 














public class MYyInterceptorl implements HandlerInterceptor { 
QOverride 
public boolean preHandle (HttpServletRequest request, 
HttpServletResponse response, 
Object handler){ 
System.out .println("MyInterceptor1l>>>preHandle"); 
return true; 
} 


QOverride 


和 
2 
| 
4 
5 
6 
3 
8 
9 
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10 public void postHandle (HttpServletRequest request, 

11 HttpServletResponse response, 

12 Object handler, 

bi | ModelAndView modelAndView){ 

14 System.out .println ("MyInterceptor1l>>>postHandle"); 
15 } 

16 QOverride 

17 public void afterCompletion (HttpServletRequest request, 
18 HttpServletResponse response, 
二 Object handler, 

20 Exception ex){ 

21 System.out .println ("MyInterceptorl>>>afterCompletion"); 











拦截 器 中 的 方法 将 按 preHandle 一 Controller 一 postHandle 一 afterCompletion 的 顺序 执行 。 注 意 ， 
只 有 preHandle 方法 返回 tue 时 后 面 的 方法 才 会 执行 。 当 拦截 器 链 内 存在 多 个 拦截 器 时 ,postHandler 
在 拦截 器 链 内 的 所 有 拦截 器 返回 成 功 时 才 会 调用 , 而 afterCompletion 只 有 preHandle 返回 true 才 调 
用 ， 但 若 拦截 器 链 内 的 第 一 个 拦截 器 的 preHandle 方法 返回 false， 则 后 面 的 方法 都 不 会 执行 。 


步骤 034 配置 拦截 器 。 定 义 配置 类 进行 拦截 器 的 配置 ， 代 码 如 下 : 


Q@Configuration 
public class WebMvcConfig implements WebMvcConfigurer { 
QOverride 
public void addInterceptors (InterceptorRegistry registry) { 
registry.addInterceptor (new MYyInterceptorl ()) 
.addPathPatterns ("/**") 
.excludePathPatterns("/hello"); 


omammmwm 





自 定义 类 实现 WebMvcConfigurer 接口 ， 实 现 接口 中 的 addInterceptors 方法 。 其 中 ， 
addPathPatterns 表示 拦截 路 径 ，excludePathPatterns 表示 排除 的 路 径 。 


步骤 044 测试 。 在 浏览 器 中 提供 /hello2 和 /hello 接口 分 别 进行 访问 ， 当 访问 hello 接口 时 ， 打 
印 日 志 ， 如 图 4-25 所 示 。 


























2018-07-14 20:41:02.915 INFO 2964 
2018-07-14 20:41:02.934 INFO 2964 
JiyInterceptorl>>>preHandle 


JfyInterceptorl>>>postHandle 
JiyInterceptorl>>>afterCompletion 





图 4-25 
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4.9 ”启动 系统 任务 





有 一 些 特殊 的 任务 需要 在 系统 启动 时 执行 ， 例 如 配置 文件 加 载 、 数 据 库 初始 化 等 操作 。 如 果 
没有 使 用 Spring Boot， 这 些 问题 可 以 在 Listener 中 解决 。Spring Boot 对 此 提供 了 两 种 解决 方案 : 
CommandLineRunner 和 ApplicationRunner。CommandLineRunner 和 ApplicationRunner 基本 一 致 ， 
差别 主要 体现 在 参数 上 。 


4.9.1 CommandLineRunner 


Spring Boot 项 目 在 启动 时 会 遍历 所 有 CommandLineRunner 的 实现 类 并 调用 其 中 的 ran 方法， 
如 果 整 个 系统 中 有 多 个 CommandLineRunner 的 实现 类 , 那么 可 以 使 用 @Order 注解 对 这 些 实现 类 的 
调用 顺序 进行 排序 。 

在 一 个 Spring Boot Web 项 目 中 添加 两 个 CommandLineRunner， 分 别 如 下 : 





1 @Component 

2 @Order (1) 

3 |public class MyCommandLineRunnerl implements CommandLineRunner { 
4 Override 

5 public void run (String... args) throws Exception { 

6 System.out .println ("Runnerl>>>"+Arrays.toString (args)); 

7 } 

8 } 


9 @Component 

10 | aorder (2) 

11 | public class MyCommandLineRunner2 implements CommandLineRunner { 
3 QOverride 











了 public void run (String... args) throws Exception { 
14 System.out.println ("Runner2>>>"+Arrays.toString (args)); 
她 } 
16 | } 
代码 解释 : 


ee (@Order(1) 注 解 用 来 描述 CommandLineRunner 的 执行 顺序 ， 数 字 越 小 越 先 执行 。 
@ run 方法 中 是 调用 的 核心 远 辑 ， 参 数 是 系统 启动 时 传 入 的 参数 ， 即 入 口 类 中 main 方法 的 参数 
(在 调用 SpringApplication run 方法 时 被 传 入 Spring Boot 项 目 中 )。 
在 系统 启动 时 ， 配 置 传 入 的 参数 。 以 IntelliJ IDEA 为 例 ， 配 置 方式 如 下 : 
步骤 014 单 击 右上 角 的 编辑 启动 配置 ， 如 图 4-26 所 示 。 

















CommendineenerApplcation ~ | >》 光 用 
1 区 Edit Configurations.. < 加 


图 4-26 
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步骤 024 在 打开 的 新 页 面 中 编辑 Program arguments, 如 果 有 多 个 参数 , 参数 之 间 用 空格 隔 开 ， 
如 图 4-27 所 示 。 

Name: | CommandlinerunnerApplication 口 share 回 Single instance only 
ess cose coverage | os 
Main class: | orgsang CommandlinerunnerApplication | 贺 
Mopions 国 
和 国 
本 二 回 ] 
Environment variables: | 
Use classpeth of madule: [Bs commendlinerunner 日 
JRE: Defaul (1.8 - SDK of commandiinerunner module 1: 回 

图 4-27 











步 又 034 启动 项 目 ， 启 动 日 志 如 图 4-28 所 示 。 








2018-07-14 21:59:30.961 INF0 6764 一 


Runmnerl>>> [三 国 演义 ， 罗 贯 中 ] 
Runmner2>>> [三 国 演义 ， 罗 贯 中 ] 


图 4-28 





在 Eclipse 中 配置 启动 参数 时 , 先 选中 启动 类 并 右 击 , 选择 Run As, 再 选择 Run Configurations， 
在 新 打开 的 页 面 中 选择 Arguments 选项 卡 ， 填 入 相关 参数 〈 多 个 参数 之 间 用 空格 隔 开 ) ， 如 图 4-29 
所 示 。 




















圈 Run Configurations x 
Create manage and run configurations 
Run a Java application © 
?加 和 | 日 加 > Name: [CommandiinerunnerApplication 
© Main|W- Arguments 、 芭 JRE | 5 classpath| By Source | 国 Environment| 口 Common 
ipse Application A | program arguments: 机 
ipse Data Tools ET 
neric Server 
neric Server(External Laund 
mt Variables.. 
lp 
Tp preview VM arguments: 
E Preview 
a Applet 
a Application 一 一 | 
CommandiinerunnerAppli, sbhs- 
人 
放 Plug-in Test et meee 
wen Build @ Defaukt: S$tworkspace_loccommandlinerunner} 
dejs Application Oother: 
Gi Framework 
jr Workspace— FleSystem— Variables, 
L ~ 
< > 
Rever A 
Filter matched 19 of 19 tems ER EE 
@ Ce ew 





图 4-29 
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4.9.2 ApplicationRunner 


ApplicationRunner 的 用 法 和 CommandLineRunner 基本 一 致 , 区 别 主要 体现 在 run 方法 的 参 








数 上 。 
在 一 个 Spring Boot Web 项 目 中 新 建 两 个 ApplicationRunner， 代 码 如 下 : 
上 QComponent 
当 @Order (2) 
3 public class MyApplicationRunnerl implements ApplicationRunner { 
4 QOverride 
5 public void run(ApplicationArguments args) throws Exception { 
6 List<String> nonOptionArgs = args.getNonOptionArgs(); 
7 System.out.println("1-nonOptionArgs>>>" + nonOptionArgs); 
8 Set<String> optionNames = args.getOptionNames(); 
9 for (String optionName : optionNames) { 
0 System.out .println("1l-key:" + optionName + ";value:" + 
1 args.getOptionValues (optionName) ) ; 
2 } 
3 } 
41} 
5 | @Component 
6 | @Order (1) 
7 | public class MyApplicationRunner2 implements ApplicationRunner { 
8 QOverride 
9 public void run(ApplicationArguments args) throws Exception { 
20 List<String> nonOptionArgs = args.getNonOptionArgs(); 
21 System.out .println("2-nonOptionArgs>>>" + nonOptionArgs); 
22 Set<String> optionNames = args.getOptionNames(); 
23 for (String optionName : optionNames) { 
24 System.out .println("2-key:" + optionName + ";value:" + 
25 args.getOptionValues (optionName) ) ; 
26 } 
27 } 
28 | ) 











代码 解释 : 


ee @Order 注解 依然 是 用 来 描述 执行 顺序 的 ， 数 字 越 小 越 优先 执行 。 

e 不 同 于 CommandLineRunner 中 run 方法 的 String 数组 参数 ， 这 里 run 方法 的 参数 是 一 个 
ApplicationArguments 对 象 , 如 果 想 从 ApplicationArguments 对 象 中 获取 入 口 类 中 main 方法 接 
收 的 参数 ,调用 ApplicationArguments 中 的 getNonOptionArgs 方法 即 可 . ApplicationArguments 
中 的 getOptionNames 方法 用 来 获取 项 目 启动 命令 行 中 参数 的 key， 例 如 将 本 项 目 打 成 jar 包 ， 
运行 java -jar xxxjar -name=Michael 命令 来 启动 项 目 ， 此 时 getOptionNames 方法 获取 到 的 就 
是 name， 而 getOptionValues 方法 则 是 获取 相应 的 value。 


接 下 来 运行 mvnpackage 命令 对 项 目 进 行 打包 ， 代 码 如 下 : 





1 | mvn package 
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进入 打包 目录 中 ， 执 行 如 下 命令 启动 项 目 : 





1 | uava -jar linerunner-0.0.1.jar --name=Michael --age=99 三 国 演义 罗贯中 





命令 解释 : 


。 --name=Michael --age=99 都 属于 getOptionNames/getOptionValues 范 暑 。 
@ ”后面 的 “三 国 演义 ”“ 罗 贯 中 ”可 以 通过 getNonOptionArgs 方法 获取 ， 获 取 到 的 是 一 个 数组 ， 
相当 于 上 文 提 到 的 运行 时 配置 的 ProgramArguments。 


项 目 启动 结果 如 图 4-30 所 示 。 





4.10 整合 Servlet、Filter 和 Listener 


- 般 情 况 下 ,使 用 Spring、\ Spring MVC 这 些 框架 之 后 ,基本 上 就 告别 Servlet、Filter 以 及 Listener 
了 ， 但 是 有 时 在 整合 一 些 第 三 方 框架 时 ， 可 能 还 是 不 得 不 使 用 Servlet， 比 如 在 整合 某 报 表 插 件 时 
就 需要 使 用 Servlet。Spring Boot 中 对 于 整合 这 些 基本 的 Web 组 件 也 提供 了 很 好 的 支持 。 
在 一 个 Spring Boot Web 项 目 中 添加 如 下 三 个 组 件 : 








1 @WebServlet ("/my") 

2 public class MyServlet extends HttpServlet { 

3 QOverride 

4 protected void doGet (HttpServletRequest req, HttpServletResponse resp){ 
5 doPost (req, resp); 

6 } 

了 QOverride 

8 protected void doPost (HttpServletRequest req, HttpServletResponse resp){ 
9 System.out .println("name>>>"+req.getParameter ("name")); 

10 } 

11 |} 


12 | @WebFilter("/*") 
13 | public class MyFilter implements Filter { 


14 QOverride 

15 public void init (FilterConfig filterConfig){ 
16 System.out .println ("MyFilter>>>init"); 

17 } 

18 QOverride 








19 public void doFilter (ServletRequest req, ServletResponse resp, FilterChain 
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20 | chain){ 

21 System.out .println("MyFilter>>>doFilter") 7 
22 chain.doFilter (req, resp); 

2 } 

24 QOverride 

25 public void destroy() { 

26 System.out .println("MyFilter>>>destroy"); 
27 } 

28 |} 


29 | @WebListener 
30 | public class MyListener implements ServletRequestListener { 











3 QOverride 
32 public void requestDestroyed(ServletRequestEvent sre) { 
33 System.out .println ("MyListener>>>requestDestroyed"); 
34 } 
35 QOverride 
36 public void requestInitialized (ServletRequestEvent sre) { 
37 System.out .println ("MyListener>>>requestInitialized"); 
38 } 

代码 解释 : 

@ 这 里 定义 了 三 个 基本 的 组 件 ， 分 别 使 用 @WebServlet、@WebFilter 和 @WebListener 三 个 注解 

进行 标记 。 


@ 这 里 以 ServletRequestListener 为 例 ， 但 是 对 于 其 他 的 Listener， 例 如 HttpSessionListener、 
ServletContextListener 等 也 是 支持 的 。 


在 项 目 入 口 类 上 添加 @ServletComponentScan 注解 ,实现 对 Servlet、Filter 以 及 Listener 的 扫描 ， 
代码 如 下 : 





QSpring BootApplication 
@ServletComponentScan 
public class ServletApplication { 
public static void main(String[] args) { 
SpringApplication.run(ServletApplication.class, args); 


} 
} 


最 后 ， 启 动 项 目 ， 在 浏览 器 中 输入 “http:Wlocalhost:8080/my?name=Michael”， 可 以 看 到 相关 
志 ， 4-31 所 示 。 


ammwm 
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2018-07-14 23:39:06. 9204 一 
2018-07-14 23:39:06. 9204 一 
MyFilter>>>init 

2018-07-14 23:39:06. 9204 一 
2018-07-14 23:39:07. 9204 一 
2018-07-14 23:39:07. 9204 一 
2018-07-14 23:39:07. 9204 一 
2018-07-14 23:39:07. 9204 一 
2018-07-14 23:39:07. 9204 一 
2018-07-14 23:39:07. 9204 一 
2018-07-14 23:39:07. 9204 一 
2018-07-14 23:39:07. 9204 一 
JIyListener>>>requestInitialized 
JiyFilter7>>doFilter 


name>> Michael 





MyListener”” requestDestroyed 


图 4-31 


4.11 路 径 映 射 


一 般 情况 下 ， 使 用 了 页 面 模板 后 ， 用 户 需 要 通过 控制 器 才能 访问 页 面 。 有 一 些 页 面 需要 在 控 
制 器 中 加 载 数据 ， 然 后 泻 染 ， 才 能 显示 出 来 ; 还 有 一 些 页 面 在 控制 器 中 不 需要 加 载 数据 ， 只 是 完成 
简单 的 跳 转 ， 对 于 这 种 页 面 ， 可 以 直接 配置 路 径 映 射 ， 提 高 访问 速度 。 例 如 ， 有 两 个 Thymeleaf 
做 模板 的 页 面 login.html 和 index.html， 直 接 在 MVC 配置 中 重 写 addViewControllers 方法 配置 映射 
关系 即 可 : 

QConfiguration 
public class WebMvcConfig implements WebMvcConfigurer { 


@Override 
public void addViewControllers (ViewControllerRegistry registry) { 


registry.addViewController ("/login") .setViewName ("login"); 
registry.addViewController ("/index") .setViewName ("index"); 





cam 必 wm 


配置 完成 后 ， 就 可 以 直接 访问 http://localhost:8080/login 等 地 址 了 。 


4.12 配置 AOP 


4.12.1 AOP 简介 





要 介绍 面向 切面 编程 (Aspect-Oriented Programming，AOP) ， 需 要 读者 首先 考虑 这 样 一 个 场 
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景 : 公司 有 一 个 人 力 资源 管理 系统 目前 已 经 上 线 , 但 是 系统 运行 不 稳定 ， 有 时 运行 得 很 慢 , 为 了 检 
测 出 到 底 是 哪个 环节 出 问题 了 , 开发 人 员 想 要 监控 每 一 个 方法 的 执行 时 间 , 再 根据 这 些 执行 时 间 判 
断 出 问题 所 在 。 当 问题 解决 后 ， 再 把 这 些 监控 移 除 掉 。 系 统 目前 已 经 运行 ， 如 果 手 动 修改 系统 中 成 
千 上 万 个 方法 ,那么 工作 量 未 免 太 大 ,而 且 这 些 监 控 方法 以 后 还 要 移 除 掉 ; 如 果 能 够 在 系统 运行 过 
程 中 动态 添加 代码 , 就 能 很 好 地 解决 这 个 需求 。 这 种 在 系统 运行 时 动态 添加 代码 的 方式 称 为 面向 切 
面 编程 《AOP) 。Spring 框架 对 AOP 提供 了 很 好 的 支持 。 在 AOP 中 ， 有 一 些 常见 的 概念 需要 读者 
了 解 。 

e Joinpoint (连接 点 ) 类 里 面 可 以 被 增强 的 方法 即 为 连接 点 。 例 如 ， 想 修改 哪个 方法 的 功能 ， 





。 Advice (通知 ) 拦截 到 Joinpoint 之 后 所 要 做 的 事情 就 是 通知 。 例 如 ， 上 文 说 到 的 打印 日 志 
监控 。 通 知 分 为 前 置 通知 、 后 置 通知 、 异 常 通知 、 最 终 通 知 和 环绕 通知 。 

@ Aspect (切面 ) Pointcut 和 Advice 的 结合 。 

e Target ( 目标 对 象 ) 要 增强 的 类 称 为 Target。 


这 些 是 对 AOP 的 简单 介绍 ， 接 下 来 看 看 如 何在 Spring Boot 中 实现 AOP。 


4.12.2 Spring Boot 支持 


Spring Boot 在 Spring 的 基础 上 对 AOP 的 配置 提供 了 自动 化 配置 解决 方案 
spring-boot-starter-aop， 使 开发 者 能 够 更 加 便捷 地 在 Spring Boot 项 目 中 使 用 AOP。 配 置 步骤 如 下 。 
首先 在 Spring Boot Web 项 目 中 引入 spring-boot-starter-aop 依赖 ， 代 码 如 下 : 





<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-aop</artifactId> 
</dependency> 





然后 在 org.sang.aop.service 包 下 创建 UserService 类 ， 代 码 如 下 : 





@Service 

public class UserService { 

public String getUserById (Integer id) { 
System.out .println("get..."); 
return "user"; 


1 

a 

3 

4 

5 

6 } 

党 public void deleteUserById(Integer id) { 
8 System.out .println("delete..."); 
9 } 
10 | } 

接 下 来 创建 切面 ， 代 码 如 下 : 


下 Component 
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到 @Aspect 

3 public class LogAspect { 

4 Q@Pointcut ("execution(* org.sang.aop.service.*.*(..))") 

5 public void pcl() { 

6 } 

7 @Before (value = "pcl()") 

8 public void before (JoinPoint jp) { 

9 String name = jp.getSignature () .getName (); 

10 System.out .println (name + "方法 开始 执行 . . .") ; 

11 } 

le @After (value = "pcl()") 

了 public void after (JoinPoint jp) { 

14 String name = jp.getSignature () .getName () ; 

15 System.out .println (name + "方法 执行 结束 . . .") ; 

16 } 

17 @AfterReturning (value = "pcl()", returning = "result") 

18 public void afterReturning (JoinPoint jp, Object result) { 
19 String name = jp.getSignature () .getName (); 

20 System.out .println(name + "方法 返回 值 为 : ”+ result); 
21 } 

22 @AfterThrowing (value = "pcl()",throwing = "e") 

23 public void afterThrowing (JoinPoint jp,Exception e) { 

24 String name = jp.getSignature () .getName (); 

25 System.out .println (name+" 方 法 抛 异 常 了 ， 异 常 是 ，"+e .getMessage () ) ; 
26 } 

27 Q@Around ("pc1 () ") 

28 public Object around (ProceedingJoinPoint pjp) throws Throwable { 
29 return pjp.proceed(); 

30 } 

31 13 





代码 解释 : 


。 @Aspect 注解 表明 这 是 一 个 切面 类 。 

@ 第 4-6 行 定义 的 pcl 方法 使 用 了 @Pointcut 注解 ， 这 是 一 个 切入 点 定义 。execution 中 的 第 一 
个 * 表 示 方 法 返回 任意 值 ， 第 二 个 * 表 示 service 包 下 的 任意 类 ， 第 三 个 * 表 示 类 中 的 任意 方法 ， 

括号 中 的 两 个 点 表示 方法 参数 任意 ， 即 这 里 描述 的 切入 点 为 service 包 下 所 有 类 中 的 所 有 方 

@ 第 7~11 行 定义 的 方法 使 用 了 (@Before 注解 ， 表示 这 是 一 个 前 置 通知 , 该 方法 在 目标 方法 执行 
之 前 执行 。 通 过 JoinPoint 参数 可 以 获取 目标 方法 的 方法 名 、 修 饰 符 等 信息 。 

@ 第 12~16 行 定义 的 方法 使 用 了 (@After 注解 ， 表示 这 是 一 个 后 置 通知 ,该 方法 在 目标 方法 执行 
之 后 执行 。 

@ 第 17-21 行 定义 的 方法 使 用 了 @AfterRetuming 注解 ， 表示 这 是 一 个 返回 通知 ， 在 该 方法 中 可 
以 获取 目标 方法 的 返回 值 。@AfterRetuming 注解 的 returning 参数 是 指 返 回 值 的 变量 名 ,对 应 
方法 的 参数 。 注 意 ， 在 方法 参数 中 定义 了 result 的 类 型 为 Object， 表 示 目 标 方法 的 返回 值 可 
以 是 任意 类 型 ， 若 result 参数 的 类 型 为 Long， 则 该 方法 只 能 处 理 目标 方法 返回 值 为 Long 的 
情况 。 





78 | Spring Boot+Vue 全 栈 开发 实战 





e 第 22-26 行 定义 的 方法 使 用 了 @AfterThrowing 注解 ， 表 示 这 是 一 个 异常 通知 ， 即 当 目 标 方法 
发 生 异常 时 ， 该 方法 会 被 调用 ， 异 常 类 型 为 Exception 表示 所 有 的 异常 都 会 进入 该 方法 中 执 
行 ,， 若 异常 类 型 为 ArithmeticException, 则 表示 只 有 目标 方法 抛 出 的 ArithmeticException 异常 
才 会 进入 该 方法 中 处 理 。 

@ 第 27-30 行 定义 的 方法 使 用 了 @Around 注解 ， 表示 这 是 一 个 环绕 通知 。 环 绕 通 知 是 所 有 通知 
里 功能 最 为 强大 的 通知 ， 可 以 实现 前 置 通知 、 后 置 通知 、 异 常 通知 以 及 返回 通知 的 功能 。 目 
标 方法 进入 环绕 通知 后 , 通过 调用 ProceedingJoinPoint 对 象 的 proceed 方法 使 目标 方法 继续 执 
行 ， 开 发 者 可 以 在 此 修改 目标 方法 的 执行 参数 、 返 回 值 等 ， 并 且 可 以 在 此 处 理 目 标 方法 的 异 

配置 完成 后 ， 接 下 来 在 Controller 中 创建 接口 ， 分 别 调用 UserService 中 的 两 个 方法 ， 即 可 看 

到 LogAspect 中 的 代码 动态 地 嵌入 目标 方法 中 执行 了 。UserController 类 的 定义 如 下 : 


@RestController 
public class UserController { 
@Autowired 
UserService userService; 
@GetMapping ("/getUserById") 
public String getUserById(Integer id) { 
return userService.getUserById (id); 
} 
@GetMapping ("/deleteUserById") 
public void deleteUserById(Integer id) { 
userService.deleteUserById(id) ; 


PPO 
Po 


} 





请 已 
WN 








4.13 其 他 


4.13.1 自 定义 欢迎 页 


Spring Boot 项 目 在 启动 后 ， 首 先 会 去 静态 资源 路 径 下 查找 index.html 作为 首页 文件 ， 若 查找 
不 到 ， 则 会 去 查找 动态 的 index 文件 作为 首页 文件 。 

例如 ， 如 果 想 使 用 静态 的 index.html 页 面 作为 项 目 首页 ， 那 么 只 需 在 resources/static 目录 下 创 
建 index.html 文件 即 可 。 若 想 使 用 动态 页 面 作为 项 目 首页 ， 则 需 在 resources/templates 目录 下 创建 
index.html (使 用 Thymeleaf 模板 ) 或 者 index.fl (使 用 FreeMarker 模板 ) ， 然 后 在 Controller 中 返 
可 逻辑 视图 名 ， 代 码 如 下 : 
Q@RequestMapping ("/index") 


public String hello() { 
return "index"; 

















} 
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最 后 启动 项 目 ， 输 入 “http:Wlocalhost:8080/” 就 可 以 看 到 项 目 首页 的 内 容 了 。 


4.13.2 自 定义 favicon 


favicon.ico 是 浏览 器 选项 卡 左上 角 的 图 标 , 可 以 放 在 静态 资源 路 径 下 或 者 类 路 径 下 ,静态 资源 
路 径 下 的 favicon.ico 优先 级 高 于 类 路 径 下 的 favicon.ico。 

可 以 使 用 在 线 转换 网 站 https://jinaconvert.com/cn/convert-to-ico.php 将 一 张 普通 图 片 转 为 .ico 图 
片 ， 转 换 成 功 后 , 将 文件 重 命名 为 favicon.ico， 然 后 复制 到 resources/static 目录 下 ， 如 图 4-32 所 示 。 


srC 





main 


” Ml java 


目 resources 
v static 
司 favicon.ico 
Bos index.html 
BP templates 


喝 application.properties 





图 4-32 


最 后 启动 项 目 ， 就 可 以 在 浏览 器 选项 卡 中 看 到 效果 了 ， 如 图 4-33 所 示 。 


© localhost:8080 





图 4-33 


4.13.3 ”除去 某 个 自动 配置 


Spring Boot 中 提供 了 大 量 的 自动 化 配置 类 ， 例 如 上 文 提 到 过 的 ErorMvcAutoConfiguration、 
ThymeleafAutoConfiguration、FreeMarkerAutoConfiguration、MmultipartAutoConfiguration 等 ， 这 些 自 
动 化 配置 可 以 减少 相应 操作 的 配置 ， 达 到 开 箱 即 用 的 效果 。 在 Spring Boot 的 入 口 类 上 有 一 个 
@Spring BootApplication 注解 。 该 注解 是 一 个 组 合 注解 ， 由 @Spring BootConfiguration 、 
@EnableAutoConfiguration 以 及 @ComponentScan 组 成 , 其 中 @EnableAutoConfiguration 注解 开启 自 
动 化 配置 ， 相 关 的 自动 化 配置 类 就 会 被 使 用 。 如 果 开 发 者 不 想 使 用 某 个 自动 化 配置 ， 按 如 下 方式 除 
去 相关 配置 即 可 : 

@Spring BootApplication 
@EnableAutoConfiguration (exclude = {ErrorMvcAutoConfiguration.class}) 


public class OtherApplication { 
public static void main (String[] args) { 





1 
2 
3 
4 
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5 SpringApplication.run(OtherApplication.class, args); 
6 } 
了 |】 

在 @EnableAutoConfiguration 注解 中 使 用 exclude 属性 除去 Error 的 自动 化 配置 类 , 这 时 如 果 在 
resources/static/error 目录 下 创建 4xx.html、5xx.html (具体 参见 4.5 节 ) ， 访 问 出 错时 就 不 会 自动 跳 
转 了 。 由 于 @EnableAutoConfiguration 注解 的 exclude 属性 值 是 一 个 数组 ， 因 此 有 多 个 要 排除 的 自 
动 化 配置 类 时 只 需 继续 添加 即 可 。 除 了 这 种 配置 方式 外 ， 开 发 者 也 可 以 在 application.properties 配 
置 文件 中 进行 配置 ， 代 码 如 下 : 



































1 | spring.autoconfigure.exclude=org.springframework.boot .autoconfigure.web.servlet .er 


ror.ErrorMvcAutoConfiguration 





4.14 小 结 


本 章 向 读者 介绍 了 Spring Boot 整合 Web 开发 时 一 些 常 见 、 有 用 的 配置 。 在 这 些 配置 中 ,大 部 
分 是 Spring MVC 的 功能 ， 只 是 在 Spring Boot 中 做 了 自动 化 配置 ， 少 部 分 是 Spring Boot 自身 提供 
的 功能 ， 例 如 CommandLineRunner。 第 5 章 将 向 读者 介绍 Spring Boot 整合 持久 层 技术 。 


Spring Boot 整合 持久 层 技术 


本 章 概要 


@ 整合 JdbcTemplate 

e 整合 MyBatis 

@ ”整合 Spring Data JPA 
@ 多 数据 源 


持久 层 是 Java EE 中 访问 数据 库 的 核心 操作 , Spring Boot 中 对 常见 的 持久 层 框架 都 提供 了 自动 
化 配置 ， 例 如 JdbcTemplate、JPA 等 ，MyBatis 的 自动 化 配置 则 是 MyBatis 官方 提供 的 。 接 下 来 分 
别 向 读者 介绍 Spring Boot 整合 这 几 种 持久 层 技术 。 


5.1 整合 JdbcTemplate 








JdbcTemplate 是 Spring 提供 的 一 套 JDBC 模板 框架 ， 利 用 AOP 技术 来 解决 直接 使 用 JDBC 时 
大 量 重复 代码 的 问题 。JdbcTemplate 虽然 没有 MyBatis 那么 灵活 , 但 是 比 直 接 使 用 JDBC 要 方便 很 
多 。Spring Boot 中 对 JdbcTemplate 的 使 用 提供 了 自动 化 配置 类 JdbcTemplateAutoConfiguration， 部 
分 源码 如 下 : 


@Configuration 
@ConditionalOnClass ({ DataSource.class, JdbcTemplate.class }) 


























@ConditionalOnSingleCandidate (DataSource.class 
@AutoConfigureAfter (DataSourceAutoConfiguration.class) 
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5 @EnableConfigurationProperties (JdbcProperties.class) 
6 public class JdbcTemplateAutoConfiguration { 

昌 Configuration 

8 static class JdbcTemplateConfiguration { 

9 Private final DataSource dataSource; 


26 | .getQueryTimeout () 

27 | .getSeconds () ) 7 

28 } 

29 return jdbcTemplate; 





10 private final JdbcProperties properties; 

Wy JdbcTemplateConfiguration (DataSource dataSource, JdbcProperties properties) { 
1 和 2 this.dataSource = dataSource; 

13 this.properties = properties; 

14 } 

15 @Bean 

16 QPrimary 

17 econditionalOnMissingBean (JdbcOperations.class) 

18 public JdbcTemplate jdbcTemplate() { 

19 JdbcTemplate jdbcTemplate = new JdbcTemplate (this.dataSource) 

20 JdbcProperties.Template template = this.properties.getTemplate(); 
2 jdbcTemplate.setFetchSize (template.getFetchSize()); 

22 jdbcTemplate.setMaxRows (template.getMaxRows () ); 

33 if (template.getQueryTimeout() != null) { 

24 jdbcTemplate 

25 .setQueryTimeout ( (int) template 





从 上 面 这 段 源码 中 可 以 看 出 ， 当 classpath 下 存在 DataSource 和 JdbcTemplate 并 且 DataSource 





只 有 一 个 实例 时 ， 自 动 配置 才 会 生效 ， 若 开发 者 没有 提供 JdbcOperations， 则 Spring Boot 会 自动 向 
容器 中 注入 一 个 JdbcTemplate (JdbcTemplate 是 JdbcOperations 的 子 类 ) 。 由 此 可 以 看 到 ， 开 发 者 
想 要 使 用 JdbcTemplate， 只 需要 提供 JdbcTemplate 的 依赖 和 DataSource 依赖 即 可 。 具 体操 作 步 又 


如 下 。 
1. 创建 数据 库 和 表 
在 数据 库 中 创建 表 ， 代 码 如 下 : 





CREATE DATABASE ‘chapter05. DEFAULT CHARACTER SET utf8; 
USE “chapter05 7 
CREATE TABLE “book`” ( 
‘id int(11) NOT NULL AUTO INCREMENT, 
‘name. varchar(128) DEFAULT NULL, 
“author ”varchar (64) DEFAULT NULL, 
PRIMARY KEY (id >) 
) ENGINE=InnoDB DEFAULT CHARSET=utf8; 
insert into ‘book‘ (“id', ‘name‘, ‘author*) values 





上 吕 下 mw 





交 7 "罗贯中 "(2 水浒 传 ",* 
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| 施 而 鹿 ') ; 
创建 chapter05 数据 库 ， 在 库 中 创建 book 表 ， 同 时 添加 两 条 测试 语句 。 
2. 创建 项 目 
创建 Spring Boot 项 目 ， 添 加 如 下 依赖 : 
<dependency> 
全 <groupId>org.springframework.boot</groupId> 
3 <artifactId>spring-boot-starter-jdbc</artifactId> 
4 </dependency> 
号 <dependency> 
6 <groupId>org.springframework.boot</groupId> 
7 <artifactId>spring-boot-starter-web</artifactId> 
8 | </dependency> 
a <dependency> 


10 | <groupId>mysql</groupId> 

11 | <artifactId>mysql-connector-java</artifactId> 
12 | <scope>runtime</scope> 

13 | </dependency> 

14 | <dependency> 

15 | <groupId>com.alibaba</groupId> 

16 | <artifactId>druid</artifactId> 

17 | <version>1.1.9</version> 

18 | </dependency> 


spring-boot-starter-jdbc 中 提供 了 spring-jdbe， 另 外 还 加 入 了 数据 库 驱 动 依 赖 和 数据 库 连接 池 
依赖 。 

3. 数据 库 配置 

在 application.properties 中 配置 数据 库 基本 连接 信息 : 


spring.datasource.type=com.alibaba.druid.pool .DruidDataSource 
spring.datasource.url=jdbc:mysql:///chapter05 
spring.datasource.username=root 
spring.datasource.password=123 


4. 创建 实体 类 
创建 Book 实体 类 ， 代 码 如 下 : 


public class Book { 
Private Integer id; 
private String name; 
private String author; 
// 省 略 getter/setter 

















ao 性 


5. 创建 数据 库 访问 层 
创建 BookDao， 代 码 如 下 : 


| Q@Repository 





说 
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久 public class BookDao { 

3 QRAutowired 

4 JdbcTemplate jdbcTemplate; 

5 public int addBook (Book book) { 

6 return jdbcTemplate.update ("INSERT INTO book (name,author) VALUES (?,?)", 
7 book.getName (), book.getAuthor()); 

8 

9 public int updateBook (Book book) { 

10 return jdbcTemplate.update ("UPDATE book SET name=?,author=? WHERE id=?", 
和 book.getName (), book.getAuthor(), book.getId()); 

12 

13 public int deleteBookById (Integer id) { 

14 return jdbcTemplate.update ("DELETE FROM book WHERE id=?", id); 

15 

16 public Book getBookById(Integer id) { 

17 return jdbcTemplate.queryForObject ("select * from book where id=?", 
18 new BeanPropertyRowMapper<> (Book.class), id); 

19 

20 public List<Book> getAllBooks() { 

21 return jdbcTemplate.query ("select * from book", 

22 new BeanPropertyRowMapper<> (Book.class)); 














代码 解释 : 


6. 


创建 BookDao， 注 入 JdbcTemplate。 由 于 已 经 添加 了 spring-jdbc 相关 的 依赖 ，JdbcTemplate 
会 被 自动 注册 到 Spring 容器 中 ， 因 此 这 里 可 以 直接 注入 JdbcTemplate 使 用 。 

在 JdbcTemplate 中 ,增删 改 三 种 类 型 的 操作 主要 使 用 update 和 batchUpdate 方法 来 完成 .query 
和 queryForObject 方法 主要 用 来 完成 查询 功能 。 另外, 还 有 execute 方法 可 以 用 来 执行 任意 的 
SQL、call 方法 用 来 调用 存储 过 程 等 。 

在 执行 查询 操作 时 ， 需 要 有 一 个 RowMapper 将 查询 出 来 的 列 和 实体 类 中 的 属性 一 一 对 应 起 
来 。 如 果 列 名 和 属性 名 都 是 相同 的 ， 那 么 可 以 直接 使 用 BeanPropertyRowMapper; 如 果 列 名 
和 属性 名 不 同 ， 就 需要 开发 者 自己 实现 RowMapper 接口 ， 将 列 和 实体 类 属性 一 一 对 应 起 来 。 


创建 Service 和 Controller 


创建 BookService 和 BookController， 代 码 如 下 : 





oor 人 ON 


记 
S 





记 
说 


QService 
public class BookService { 


QRAutowired 

BookDao bookDao; 

public int addBook (Book book) { 
return bookDao .addBook (book); 

} 

public int updateBook (Book book) { 
return bookDao.updateBook (book); 

} 

public int deleteBookById (Integer id) { 
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12 return bookDao.deleteBookById (id); 

13 } 

14 public Book getBookById (Integer id) { 

5 return bookDao.getBookById (id); 

16 } 

17 public List<Book> getAllBooks() { 

18 return bookDao.getAllBooks (); 

19 } 

20 | } 

21 | @RestController 

22 | public class BookController { 

23 QAutowired 

24 BookService bookService; 

25 @GetMapping ("/bookOps") 

26 public void bookops() { 

27 Book bl = new Book(); 

28 bl .setName (" 西 厢 记 ") ; 

29 bl1.setRuthor (" 王 实 甫 ") ; 

30 int i = bookService.addBook (bl1); 

31 System.out.println("addBook>>>" + i); 

32 Book b2 = new Book(); 

33 b2.setId(1); 

34 b2 .setName (" 朝 花 夕 拾 ") ; 

35 b2.setRuthor ("鲁迅 "); 

36 int updateBook = bookService.updateBook (b2); 
37 System.out .println ("updateBook>>>"+updateBook); 
38 Book b3 = bookService.getBookById (1); 

39 System.out .println ("getBookById>>>"+b3); 

40 int delete = bookService.deleteBookById(2); 

41 System.out .println("deleteBookById>>>"+delete); 
42 List<Book> allBooks = bookService.getAllBooks(); 
43 System.out .println("getAllBooks>>>"+tallBooks); 











最 后 ， 在 浏览 器 中 访问 http://localhost:8080/bookOps 地 址 ， 控 制 台 打印 日 志 如 图 5-1 所 示 。 


addBook>>>1 
updateBook>>)1 

BetBookById>>>Book {id=1，name=" 朝 花 夕 拾 ' ，author=' 和 鲁迅 '} 

deleteBookById>>>1 

getAllBooks》》[Book {id=1，name=' 朝 花 夕 拾 ' ，author=' 鲁迅 '}，Book {id=4，name=' 西厢记 ' ，author=' 王 实 赴 ')] 








图 5-1 
数据 库 中 的 数据 如 图 5-2 所 示 。 





id name author 
四 亏 花 夕 拾 鲁迅 
3 西厢记 王 实 青 





图 5-2 
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5.2 整合 MyBatis 





MyBatis 是 一 款 优秀 的 持久 层 框 架 ， 原 名 叫 作 iBaits，2010 年 由 ApacheSoftwareFoundation 迁 
移 到 Google Code 并 改名 为 MyBatis，2013 年 又 迁移 到 GitHub 上 。MyBatis 支持 定制 化 SQL、 存 
储 过 程 以 及 高 级 映射 。MyBatis 几乎 避免 了 所 有 的 JDBC 代码 手动 设置 参数 以 及 获取 结果 集 。 在 传 
统 的 SSM 框架 整合 中 ， 使 用 MyBatis 需要 大 量 的 XML 配置 ， 而 在 Spring Boot 中 ，MyBatis 官方 
提供 了 一 套 自动 化 配置 方案 ， 可 以 做 到 MyBatis 开 箱 即 用 。 有 具体 使 用 步骤 如 下 。 


1. 创建 项 目 
创建 Spring Boot 项 目 ， 添 加 MyBatis 依赖 、 数 据 库 驱 动 依赖 以 及 数据 库 连接 池 依 赖 ， 代 码 如 








1 <dependency> 

2 <groupId>org.springframework.boot</groupId> 

3 <artifactId>spring-boot-starter-web</artifactId> 
4 | </dependency> 

5 <dependency> 

6 |<groupId>org.mybatis.spring.boot</groupId> 

7 <artifactId>mybatis-spring-boot-starter</artifactId> 
8 <version>1.3.2</version> 

9 | </dependency> 

10 | <dependency> 

11 | <groupId>com.alibaba</groupId> 

12 | <artifactId>druid</artifactId> 

13 | <version>1.1.9</version> 

14 | </dependency> 

15 | <dependency> 

16 | <groupId>mysql</groupId> 

17 | <artifactId>mysql-connector-java</artifactId> 

18 | <scope>runtime</scope> 

19 | </dependency> 








2. 创建 数据 库 、 表 、 实 体 类 等 

数据 库 和 表 、 实 体 类 以 及 application.properties 中 配置 的 数据 库 连 接 信息 都 与 上 一 节 一 致 ， 这 
里 不 再 袭 述 。 

3. 创建 数据 库 访 问 层 

创建 BookMapper， 代 码 如 下 : 





9 @Mapper 

2 | public interface BookMapper { 

3 int addBook (Book book); 

4 int deleteBookById(Integer id) 
S int updateBookById (Book book); 
6 Book getBookById(); 

时 List<Book> getAllBooks () 7 
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8 |) 














代码 解释 : 


e@ 在 项 目的 根 包 下 面 创建 一 个 子 包 Mapper， 在 Mapper 中 创建 BookMapper。 

@ 有 两 种 方式 指明 该 类 是 一 个 Mapper: 第 一 种 如 前 面 的 代码 所 示 ， 在 BookMapper 上 添加 
@Mapper 注解 ， 表 明 该 接口 是 一 个 MyBatis 中 的 Mapper， 这 种 方式 需要 在 每 一 个 Mapper 上 
都 添加 注解 ， 还 有 一 种 简单 的 方式 是 在 配置 类 上 添加 @MapperScan("org.sang.mapper") 注 解 ， 
表示 扫描 org.sang.mapper 包 下 的 所 有 接口 作为 Mapper， 这 样 就 不 需要 在 每 个 接口 上 配置 
@Mapper 注解 了 。 


4. 创建 BookMapper.xml 
在 与 BookMapper 相同 的 位 置 创建 BookMapperxml 文件 ， 代 码 如 下 : 








1 <?xml version="1.0" encoding="UTF-8" ?> 
2 <!DOCTYPE mapper 
半 PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
4 "http://mybatis.org/dtd/mybatis-3-mapper.dtd"> 
5 <mapper namespace="org.sang.mapper .BookMapper"> 
6 <insert id="addBook" parameterType="org.sang.model .Book"> 
7 INSERT INTO book (name,author) VALUES (#{name},#{author}) 
8 | </insert> 
9 | <delete id="deleteBookById" parameterType="int"> 
10 DELETE FROM book WHERE id=#{id} 
11 | </delete> 
12 | <update id="updateBookById" parameterType="org.sang.model .Book"> 
13 UPDATE book set name=#{name},author=#{author} WHERE id=#{id} 
14 | </update> 
15 | <select id="getBookById" parameterType="int" resultType="org.sang.model .Book"> 
16 SELECT * FROM book WHERE id=#{id} 
17 | </select> 
18 | <select id="getAllBooks" resultType="org.sang.model .Book"> 
19 SELECT * FROM book 
20 | </select> 
21 | </mapper> 
代码 解释 : 


an 必 wm 


@ ”针对 BookMapper 接口 中 的 每 一 个 方法 都 在 BookMapperxml 中 列 出 了 实现 。 
日 # 和 用 来 代替 接口 中 的 参数 ， 实 体 类 中 的 属性 可 以 直接 通过 #{ 实 体 类 属性 名 } 获 取 。 


5. 创建 Service 和 Controller 
创建 BookService 与 BookController， 代 码 如 下 : 





@Service 
public class BookService { 
QAutowired 


BookMapper bookMapper; 
public int addBook (Book book) { 
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6 return bookMapper .addBook (book) ; 

7 

8 public int updateBook (Book book) { 

9 return bookMapper .updateBookById (book); 
10 

11 public int deleteBookById (Integer id) { 
过 return bookMapper.deleteBookById(id); 
3 

14 public Book getBookById(Integer id) { 

15 return bookMapper.getBookById (id); 

16 

17 public List<Book> getAllBooks() { 

18 return bookMapper.getAllBooks () 

19 

20 |} 


21 | 4RestController 
22 | public class BookController { 


23 @Autowired 

24 BookService bookService; 

25 @GetMapping ("/bookOps") 

26 public void bookOps() { 

2 Book bl = new Book(); 

28 bl .setName (" 西 厢 记 ") ; 

29 bl1.setRuthor (" 王 实 甫 ") ; 

30 int i = bookService.addBook(bl) 

J System.out .println ("addBook>>>" + i); 

32 Book b2 = new Book(); 

33 b2.setId(1); 

34 b2.setName (" 朝 花 夕 拾 ") ; 

35 b2.setAuthor ("鲁迅 "); 

36 int updateBook = bookService.updateBook (b2); 

37 System.out .println("updateBook>>>"+updateBook) 
38 Book b3 = bookService.getBookById(1) 

39 System.out .println ("getBookById>>>"+b3); 

40 int delete = bookService.deleteBookById(2); 

41 System.out .println("deleteBookById>>>"+delete) 7 
42 List<Book> allBooks = bookService.getAllBooks(); 
43 System.out .println("getAllBooks>>>"tallBooks); 
44 } 

45 | } 





6. 配置 pom.xml 文件 


在 Maven 工程 中 ，XML 配置 文件 建议 写 在 resources 目录 下 ， 但 是 上 文 的 Mapperxml 文件 写 








在 包 下 ，Maven 在 运行 时 会 忽略 包 下 的 XML 文件 ， 因 此 需要 在 pom_.xml 文件 中 对 














位 置 ， 配置 如 下 : 


新 指明 资源 文件 





<build> 
<resources> 


<resource> 


ODP 


<directory>src/main/java</directory> 
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入 <includes> 

6 <include>**/*.xml</include> 

7 </includes> 

8 </resource> 

3 <resource> 

10 | <directory>src/main/resources</directory> 
11 | </resource> 

12 | </resources> 

13 | </build> 


接 下 来 在 浏览 器 中 输入 “http://localhost:8080/bookOps”， 即 可 看 到 数据 库 中 数据 的 变化 ， 控 
制 台 也 打印 出 相应 的 日 志 ， 如 图 5-3 所 示 。 











Book (id=1，name=" 朝 社 夕 拾 '，author= 鲁迅 


deleteBookById>))0 
eetAllBooks>》>[Book (id=1，name= 朝 花 夕 拍 " ，author= 鲁迅 ')}，Book {id=3，name= 西厢记 ，author=" 王 实 十 " }，Book (id=5，name= 西厢记 ，author=' 王 实 十 ") 


图 5-3 


通过 上 面 的 例子 可 以 看 到 ，MyBatis 基本 上 实现 了 开 箱 即 用 的 特性 。 自 动 化 配置 将 开发 者 从 繁 
杂 的 配置 文件 中 解脱 出 来 ， 以 专注 于 业务 逻辑 的 开发 。 





5.3 整合 Spring Data JPA 


JPA (Java Persistence API) 和 Spring Data 是 两 个 范畴 的 概念 。 

作为 一 名 Java EE 工程 师 ， 基 本 都 有 听 说 过 Hibernate 框架 。Hibernate 是 一 个 ORM 框架 ， 而 
JPA 则 是 一 种 ORM 规范 ，JPA 和 Hibemate 的 关系 就 像 JDBC 与 JDBC 驱动 的 关系 ， 即 JPA 制定 
了 ORM 规范 ， 而 Hibernate 是 这 些 规范 的 实现 〈 事 实 上 ， 是 先 有 Hibernate 后 有 JPA，JPA 规范 的 
起 草 者 也 是 Hibemate 的 作者 ) ， 因 此 从 功能 上 来 说 ，JPA 相当 于 Hibernate 的 一 个 子 集 。 

Spring Data 是 Spring 的 一 个 子 项 目 ， 致 力 于 简化 数据 库 访 问 ， 通 过 规范 的 方法 名 称 来 分 析 开 
发 者 的 意图 ， 进 而 减少 数据 库 访问 层 的 代码 量 。Spring Data 不 仅 支 持 关 系 型 数据 库 ， 也 支持 非 关 
系 型 数据 库 。Spring Data JPA 可 以 有 效 简化 关系 型 数据 库 访 问 代 码 。 

Spring Boot 整合 Spring Data JPA 的 步骤 如 下 。 


1. 创建 数据 库 
创建 数据 库 jpa， 代 码 如 下 : 
[TcRgarg DATABASE 、jpa、DEFRULT CHARACTER SETauttt | 
注意 


创建 数据 库 即 可 ， 不 用 创建 表 。 
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2. 创建 项 目 
创建 Spring Boot 项 目 ， 添 加 MySQL 和 Spring Data JPA 的 依赖 ， 代 码 如 下 : 


<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-data-jpa</artifactId> 
</dependency> 

<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 
</dependency> 

<dependency> 

<groupId>com.alibaba</groupId> 
<artifactId>druid</artifactId> 
<version>1.1.9</version> 

</dependency> 

<dependency> 

<groupId>mysql</groupId> 
<artifactId>mysql-connector-java</artifactId> 
<scope>runtime</scope> 

</dependency> 


3. 数据 库 配置 
在 application.properties 中 配置 数据 库 基本 信息 以 及 JPA 相关 配置 : 


spring.datasource.type=com.alibaba.druid.pool.DruidDataSource 
spring.datasource.url=jdbc:mysql:///jpa 

spring.datasource.username=root 

spring.datasource.password=123 

spring.jpa.show-sql=true 

spring.jpa.database=mysql 

spring.jpa.hibernate.ddl-auto=update 
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect .MySQL57Dialect 


这 里 的 配置 信息 主要 分 为 两 大 类 ， 第 1~4 行 是 数据 库 基 本 信息 配置 ， 第 5~8 行 是 JPA 相关 配 
置 。 其 中 ， 第 5 行 表示 是 否 在 控制 台 打 印 JPA 执行 过 程 生成 的 SQL， 第 6 行 表示 JPA 对 应 的 数据 
库 是 MySQL， 第 7 行 表示 在 项 目 启动 时 根据 实体 类 更 新 数据 库 中 的 表 〈 其 他 可 选 值 有 create、 
create-drop、validate、no) ， 第 8 行 则 表示 使 用 的 数据 库 方言 是 MySQL57Dialect。 

4. 创建 实体 类 

创建 Book 实体 类 ， 代 码 如 下 : 


oamwmmwm 











camwm 必 wm 














时 @Entity (name = "t book") 

2 public class Book { 

3 @Id 

4 QGeneratedValue (strategy = GenerationType.IDENTITY) 
入 private Integer id; 

6 Q@Column (name = "book name",nullable = false) 

全 private String name; 
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8 private String author; 
9 private Float price; 
10 | @Transient 
11 | private String description; 
12 // 省 略 getter/setter 
| 
代码 解释 : 
。 @Entity 注解 表示 该 类 是 一 个 实体 类 ， 在 项 目 启动 时 会 根据 该 类 自动 生成 一 张 表 ， 表 的 名 称 
即 @Entity 注解 中 name 的 值 ， 如 果 不 配 置 name， 默 认 表 名 为 类 名 。 
@ 所 有 的 实体 类 都 要 有 主键 ，@Id 注解 表示 该 属性 是 一 个 主键 ，@GeneratedValue 注解 表示 主 
键 自动 生成 ，strategy 则 表示 主键 的 生成 策略 。 
@ ”默认 情况 下 ,生成 的 表 中 字段 的 名 称 就 是 实体 类 中 属性 的 名 称 , 通过 @Column 注解 可 以 定制 
生成 的 字段 的 属性 ，name 表示 该 属性 对 应 的 数据 表 中 字段 的 名 称 ,nullable 表示 该 字段 非 空 
。 @Transient 注解 表示 在 生成 数据 库 中 的 表 时 ， 该 属性 被 忽略 ， 即 不 生成 对 应 的 字段 。 
5. 创建 BookDao 接口 
创建 BookDao 接口 ， 继 承 JpaRepository， 代 码 如 下 : 
1 |public interface BookDao extends JpaRepository<Book, Integer>{ 
2 List<Book> getBooksByAuthorStartingWith (String author); 
3 List<Book> getBooksByPriceGreaterThan (Float price); 
4 @Query (value = "select * from t book where id=(select max(id) from t book)", 
$5 nativeQuery = true) 
6 Book getMaxIdBook () ; 
和 @Query ("select b from t book b where b.id>:id and b.author=:author") 
8 List<Book> getBookByIdAndAuthor (@Param("author") String author, 
9 @Param("id") Integer id); 
10 | @Query ("select b from t book b where b.id<?2 and b.name like %?1%") 
11 | List<Book> getBooksByIdAndName (String name, Integer id); 
12 | } 





代码 解释 : 

ee 自 定义 BookDao 继承 自 JpaRepository。JpaRepository 中 提供 了 一 些 基本 的 数据 操作 方法 ， 有 
基本 的 增删 改 查 、 分 页 查询 、 排 序 查询 等 。 

@ 第 2 行 定义 的 方法 表示 查询 以 某 个 字符 开始 的 所 有 书 。 

e@ 第 3 行 定义 的 方法 表示 查询 单价 大 于 某 个 值 的 所 有 书 。 

@ 在 Spring Data JPA 中 , 只 要 方法 的 定义 符合 既定 规范 , Spring Data 就 能 分 析出 开发 者 的 意图 ， 
从 而 避免 开发 者 定义 SQL。 所 谓 的 既定 规范 ， 就 是 一 定 的 方法 命名 规则 。 支 持 的 命名 规则 如 
表 5-1 所 示 。 


表 5-1 支持 的 命名 规则 











KeyWords 方法 命名 举例 对 应 的 SQL 
And findByNameAndAge where name= ? and age =? 
Or findByNameOrAge where name= ? or age=? 
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( 续 表 ) 
KeyWords 方法 命名 举例 对 应 的 SQL 
Is findByAgels where age=? 
Equals findByIdEquals where id= ? 
Between findByAgeBetween Where age between ? and ? 








LessThan findByAgeLessThan where age <? 
LessThanEquals findByAgeLessThanEquals Where age <=? 





























GreaterThan findByAgeGreaterThan Where age >? 
GreaterThanEquals findByAgeGreaterThanEquals where age >=? 

After findByAgeAfter where age >? 

Before findByAgeBefore where age <? 

IsNull findByNameIsNull where name is null 
isNotNull,NotNull findByNameNotNull where name is not null 

Not findByGenderNot where gender <>? 

In findByAgeIn where age in (7?) 

NotIn findByAgeNotIn where age not in (7?) 

NotLike findByNameNotLike where name not like ? 

Like findByNameLike where name like ? 

Starting With findByNameStartingWith Where name like 7?% 
EndingWith findByNameEndingWith Where name like '%7' 
Containing,Contains findByNameContaining Where name like '%07%' 
OrderBy findByAsgeGreaterIhanOrderByIdDesc Where age>? order by id desc 
Tme findByEnabledTue where enabled= true 

False findByEnabledFalse where enabled= false 
JenoreCase findByNameIenoreCase where UPPER(name)=UPPER(?) 


@ ”既定 的 方法 命名 规则 不 一 定 满足 所 有 的 开发 需求 ， 因 此 Spring Data JPA 也 支持 自 定 义 JPQL 
( Java Persistence Query Language ) 或 者 原生 SQL, 第 4-6 行 表示 查询 i 最 大 的 书 ,nativeQuery 
=true 表示 使 用 原生 的 SQL 查询 。 

@ 第 7-9 行 表 示 根 据 id 和 author 进行 查询 ， 这 里 使 用 默认 的 JPQL 语句 。JPQL 是 一 种 面向 对 
象 表达 式 语言 , 可 以 将 SQL 语法 和 简单 查询 语义 绑 定 在 一 起 ,使 用 这 种 语言 编写 的 查询 是 可 
移植 的 ， 可 以 被 编译 成 所 有 主流 数据 库 服务 器 上 的 SQL。JPQL 与 原生 SQL 语 名 类似， 并且 
完全 面向 对 象 ， 通过 类 名 和 属性 访问 ,而 不 是 表 名 和 表 的 属性 ( 用 过 Hibernate 的 读者 会 觉得 

这 类 似 于 HQL )。 第 7~9 行 的 查询 使 用 :id、:name 这 种 方式 来 进行 参数 绑 定 。 注 意 : 这 里 使 


用 的 列 名 是 属性 的 名 称 而 不 是 数据 库 中 列 的 名 称 。 


@ 第 10、11 行 也 是 自 定义 JPQL 查询 ， 不 同 的 是 传 参 方式 使 用 ?1、?2 这 各 方式。 注意: 方法 中 
参数 的 顺序 要 与 参数 声明 的 顺序 一 致 。 

@ 如果 BookDao 中 的 方法 涉及 修改 操作 ， 就 需要 添加 @Modifying 注解 并 添加 事务 。 

6. 创建 BookService 

创建 BookService， 代 码 如 下 : 





第 5 章 Spring Boot 整合 持久 层 技术 | 93 








1 @Service 

2 public class BookService { 

3 QAutowired 

4 BookDao bookDao; 

5 public void addBook (Book book) { 

6 bookDao. save (book); 

7 

8 public Page<Book> getBookByPage (Pageable pageable) { 

9 return bookDao.findAll (pageable); 

10 

i public List<Book> getBooksByAuthorStartingWith (String author){ 
12 return bookDao.getBooksByAuthorStartingWith (author); 

13 

14 public List<Book> getBooksByPriceGreaterThan (Float price){ 

15 return bookDao.getBooksByPriceGreaterThan (price); 

16 

1 public Book getMaxIdBook(){ 

18 return bookDao.getMaxIdBook() 

19 

20 public List<Book> getBookByIdAndAuthor (String author, Integer id){ 
21 return bookDao.getBookByIdAndAuthor (author, id); 

22 

23 public List<Book> getBooksByIdAndName (String name, Integer id){ 
24 return bookDao.getBooksByIdAndName (name, id); 














代码 解释 : 


@ 第 6 行使 用 save 方 法 将 对 象 数据 保存 到 数据 库 ，save 方法 是 由 JpaRepository 接口 提供 的 。 
e 第 9 行 是 一 个 分 页 查询 ， 使 用 findAll 方 法， 返回 值 为 Page<Book>， 该 对 象 中 包含 有 分 页 常 
用 数据 ， 例 如 总 记录 数 、 总 页 数 、 每 页 记录 数 、 当 前 页 记录 数 等 。 


7. 创建 BookController 
创建 BookController， 实 现 对 数据 的 测试 : 


@RestController 
public class BookController { 
QAutowired 
BookService bookService; 
Q@GetMapping ("/findAll") 
public void findAll() { 
PageRequest pageable = PageRequest.of (2, 3); 
Page<Book> page = bookService.getBookByPage (pageable); 
System.out.println (" 总 页 数 :"+page.getTotalPages ()); 
10 System.out .println(" 总 记录 数 :"+page.getTotalElements ()) 
得 System.out .println ("查询 结果 :"+page.getContent ()); 
12 System.out .println ("当前 页 数 :"+ (page.getNumber ()+1)); 
二 System.out .println(" 当 前 页 记录 数 :"+page.getNumberOfElements () ) 
14 System.out .println ("每 页 记录 数 : "+page.getSize()); 





OooODP 
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15 } 

16 Q@GetMapping ("/search") 

Ww public void search() { 

18 List<Book> bsl = bookService.getBookByIdAndAuthor (" 鲁 迅 "，7) ; 
19 List<Book> bs2 = bookService.getBooksByAuthorstartingWith (" 吴 ") 7 
20 List<Book> bs3 = bookService.getBooksByIdAndName (" 西 "，8) ; 
21 List<Book> bs4 = bookService.getBooksByPriceGreaterThan (30F); 
ed Book b = bookService.getMaxIdBook (); 

ek | System.out .println("bsl:"+bs1); 

24 System.out .println ("bs2:"+bs2); 

System.out .println("bs3:"+bs3); 

26 System.out .println ("bs4:"+bs4); 

ea | System.out .println("b:"+b); 

28 } 

29 Q@GetMapping ("/save") 

30 public void save() { 

31 Book book = new Book(); 

32 book. setAuthor (" 鲁 迅 ") ; 

33 book. setName ("呐喊 ") ; 

34 book. setPrice (23F); 

35 bookService.addBook (book) 

36 } 

3 











代码 解释 : 


e@ 在 findAll 接 口中 ， 首 先 通过 调用 PageRequest 中 的 of 方法 构造 PageRequest 对象。of 方 法 接 
收 两 个 参数 : 第 一 个 参数 是 页 数 ， 从 0 开始 计 ; 第 二 个 参数 是 每 页 显示 的 条 数 。 

@ 在 save 接 口中 构造 一 个 Book 对 象 ， 直 接 调 用 save 方法 保存 起 来 即 可 。 

8. 测试 

最 后 调用 相关 接口 进行 测试 ， 数 据 库 中 的 测试 数据 如 图 5-4 所 示 。 


一 本 一 一 十 





语 [ 放 0 时 


Laby 








首先 调用 http://localhost:8080/findAll 接口 ， 控 制 台 打印 日 志 如 图 5-5 所 示 。 
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总 页 数 :3 
查询 结果 : [Book {id=7，name= 故事 新 编 ' ，author=' 鲁迅 ' ，price=22. 0，description="null’}] 


当前 页 记录 数 :1 
每 页 记录 数 :3 








图 5-5 


接 下 来 调用 http://localhost:8080/save 接口 ， 调 用 后 数据 库 中 的 数据 如 图 5-6 所 示 。 





Hibernate: select * from t_book where id=(select max(id) from +t_book) 


bsl: [Book {id=8，name=" 呐喊 "，author=’ 鲁迅 '，price=23. 0，description= null’}] 
Book {id=3, 游记 ，author=' 吴 承 园 *，price=29.0，description="null’}] 
bs3: [Book {id=3，name= 西游 记 ”，author=' 吴 承 辕 '"，price=29.0，description=’null’}] 
bs 
name=' 宋 诗 选 注 ' ，author= ' 钱 钟 书 " ，price=33. 0，description=’ null’}] 
b:Boolk {id=8，name=' 呐喊 '，author= 鲁迅 ' ，price=23. 0，description=’ null’} 











4: [Book {id=2，name=' 红楼梦 ' ，author=' 曹 雪上 蕙 ' ，price=35. 0，description= null’}，Book {id=5, 





图 5-7 


5.4 多 数据 源 











样 


以 把 数据 





即 可 





置 多 数据 源 ，Spring Boot 继承 其 衣钵 ， 只 不 过 配置 方式 有 所 变化 。 


所 谓 多 数据 源 , 就 是 一 个 Java EE 项 目 中 采用 了 不 同 数 据 库 实例 中 的 多 个 库 , 或 者 同一 个 数据 
库 实例 中 多 个 不 同 的 库 。 一 般 来 说 ， 采 用 MyCat 等 分 布 式 数据 库 中 间 件 是 比较 好 的 解决 方案 ， 
库 读 写 分 离 、 分 库 分 表 、 备 份 等 操作 交 给 中 间 件 去 做 ，Java 代码 只 需要 专注 于 业务 
|。 不 过 ， 这 并 不 意味 着 无 法 使 用 Java 代码 解决 类 似 的 问题 ， 在 Spring Framework 中 就 可 以 配 


这 
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5.4.1 JdbcTemplate 多 数据 源 


JdbcTemplate 多 数据 源 的 配置 是 比较 简单 的 , 因为 一 个 JdbcTemplate 对 应 一 个 DataSource, 开 








发 者 只 需要 手动 提供 多 个 DataSource， 再 手动 配置 JdbcTemplate 即 可 。 上 有 具体 步 骤 如 下 。 








1. 创建 数据 库 
创建 两 个 数据 库 : chapter05-1 和 chapter05-2。 两 个 库 中 都 创建 book 表 ， 再 各 预 设 1 条 数据 ， 
创建 脚本 如 下 : 
bE CREATE DATABASE ‘chapter05-1. DEFAULT CHARACTER SET utf8; 
2 use “chapter05-1 `; 
学 CREATE TABLE “book` ( 
4 “id* int(11) NOT NULL AUTO INCREMENT, 
5 ‘name. varchar(128) DEFAULT NULL, 
6 “author ”varchar (128) DEFAULT NULL, 
7 PRIMARY KEY (“id*) 
8 ) ENGINE=InnoDB AUTO INCREMENT=2 DEFAULT CHARSET=utf8; 
9 insert into “book` (“id`, ‘name`, “author`) values (1, "水浒 传 ', ' 施 耐 讶 '); 
10 
11 | CREATE DATABASE ‘chapter05-2* DEFAULT CHARACTER SET utf8; 
12 | use “chapter05-2 
13 | CREATE TABLE ‘book. ( 
14 ‘id int(11) NOT NULL AUTO INCREMENT, 
15 ‘name* varchar(128) DEFAULT NULL, 
16 “author ”varchar (128) DEFAULT NULL, 
17 PRIMARY KEY (‘id) 
18 | ) ENGINE=InnoDB AUTO INCREMENT=3 DEFAULT CHARSET=utf£8; 
19 | insert into “book` (“id`, ‘name`, “author`) values (1, ' 三 国 演义 ', "罗贯中 ') ; 





执行 完 数据 库 脚本 后 ， 数 据 库 中 的 数据 如 图 5-8 所 示 。 
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2. 创建 项 目 
创建 Spring Boot Web 项 目 ， 添 加 如 下 依赖 : 











1 <dependency> 
<groupId>org.springframework.boot</groupId> 

a <artifactId>spring-boot-starter-jdbc</artifactId> 
4 </dependency> 

5 <dependency> 

6 <groupId>org.springframework.boot</groupId> 

2 <artifactId>spring-boot-starter-web</artifactId> 
8 </dependency> 

9 <dependency> 

10 | <groupId>com.alibaba</groupId> 

11 | <artifactId>druid-spring-boot-starter</artifactId> 
12 | <version>1.1.10</version> 

13 | </dependency> 

14 | <dependency> 

15 | <groupId>mysql</groupId> 

16 | <artifactId>mysql-connector-java</artifactId> 

17 | <scope>runtime</scope> 

18 | </dependency> 


注意 这 里 添加 的 数据 库 连 接 池 依赖 是 druid-spring-boot-starter。druid-spring-boot-starter 可 以 帮 
助 开 发 者 在 Spring Boot 项 目 中 轻松 集成 Druid 数据 库 连 接 池 和 监控 。 


3. 配置 数据 库 连 接 
在 application.properties 中 配置 数据 库 连 接 信息 ， 代 码 如 下 : 
# 数据 源 1 


spring.datasource.one.type=com.alibaba.druid.pool.DruidDataSource 
spring.datasource.one.username=root 
spring.datasource.one.password=123 
spring.datasource.one.url=jdbc:mysql:///chapter05-1 

# 数据 源 2 
spring.datasource.two.type=com.alibaba.druid.pool.DruidDataSource 
spring.datasource.two.username=root 
spring.datasource.two.password=123 
spring.datasource.two.url=jdbc:mysql:///chapter05-2 


配置 两 个 数据 源 ， 区 别 主要 是 数据 库 不 同 ， 其 他 都 是 一 样 的 。 
4. 配置 数据 源 
创建 DataSourceConfig 配置 数据 源 ， 根 据 application.properties 中 的 配置 生成 两 个 数据 源 : 





ooDpp 








卢 
© 








@Configuration 
public class DataSourceConfig { 
QBean 
Q@ConfigurationProperties ("spring.datasource.one") 
DataSource dsone() { 
return DruidDataSourceBuilder.create() .build(); 


ao 性 





98 | Spring Boot+Vue 全 栈 开发 实战 




















} 
8 QBean 
Q@ConfigurationProperties ("spring.datasource.two") 

10 DataSource dsTwo() { 
11 return DruidDataSourceBuilder.create() .build(); 
12 } 
13 413 

代码 解释 : 


e@ DataSourceConfig 中 提供 了 两 个 数据 源 : dsOne 和 dsTwo， 默 认 方法 名 即 实例 名 。 

e (@ConfigurationProperties 注解 表示 使 用 不 同 前 组 的 配置 文件 来 创建 不 同 的 DataSource 实例 。 
5. 配置 JdbcTemplate 

在 5.1 节 中 , 读者 已 经 了 解 到 只 要 引入 了 spring-jdbc 依赖 ,那么 开发 者 没有 提供 JdbcTemplate 


实例 时 ，Spring Boot 默认 会 提供 一 个 JdbcTemplate 实例 。 现 在 配置 多 数据 源 时 ， 由 开发 者 自己 提 
供 JdbcTemplate 实例 ， 代 码 如 下 : 





@Configuration 
public class JdbcTemplateConfig { 
QBean 
JdbcTemplate jdbcTemplateOne (@Qualifier ("dsOne")DataSource dataSource) { 
return new JdbcTemplate (dataSource); 
} 
QBean 
JdbcTemplate jdbcTemplateTwo (@Qualifier ("dsTwo")DataSource dataSource) { 
return new JdbcTemplate (dataSource); 





Pppoo 和 oop 





代码 解释 : 

® JdbcTemplateConfig 中 提供 两 个 JdbcTemplate 实例 。 每 个 JdbcTemplate 实例 都 需要 提供 
DataSource, 由 于 Spring 容器 中 有 两 个 DataSource 实例 ,因此 需要 通过 方法 名 查找 .@Qualifier 
注解 表示 查找 不 同名 称 的 DataSource 实例 注入 进来 。 

6. 创建 BookController 

创建 实体 类 Book 和 BookController 进行 测试 : 








public class Book { 
private Integer id; 
private String name; 
private String author; 
// 省 略 getter/setter 

} 

@RestController 

public class BookController { 
Q@Resource (name = "jdbcTemplateOne") 
JdbcTemplate jdbcTemplateOne; 
QAutowired 


oOoODNDPp 


js 
So 





记 
忆 
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12 QQualifier ("jdbcTemplateTwo") 

33 JdbcTemplate jdbcTemplateTwo; 

14 Q@GetMapping ("/test1" 

5 public void test1() { 

16 List<Book> booksl = jdbcTemplateOne.query ("select * from book", 
17 new BeanPropertyRowMapper<> (Book.class)); 

18 List<Book> books2 = jdbcTemplateTwo.query ("select * from book", 
好 new BeanPropertyRowMapper<> (Book.class)); 

20 System.out .println ("booksl1:"+books1); 

21 System.out .println ("books2:"+books2); 











简单 起 见 ， 这 里 没有 添加 Service 层 ， 而 是 直接 将 JdbcTemplate 注入 到 了 Controller 中 。 在 
Controller 中 注入 两 个 不 同 的 JdbcTemplate 有 两 种 方式 : 一 种 是 使 用 @Resource 注解 ， 并 指明 name 
属性 ， 即 按 name 进行 装配 ， 此 时 会 根据 实例 名 查找 相应 的 实例 注入 ; 另 一 种 是 使 用 @Autowired 
注解 结合 @Qualifier 注解 ， 效 果 等 同 于 使 用 @Resource 注解 。 


7. 测试 
最 后 ， 在 浏览 器 地 址 栏 输入 “http:Wlocalhost:808OHestl ”， 控 制 台 打 印 日 志 如 图 5-9 所 示 。 
JdbcTemplate 多 数据 源 配 置 成 功 。 
2018-07-16 22:40:07.194 IINF0 120 一 [nio-8080-exec-2] 
booksl: [Book {id=1，name=' 水 洲 传 ' ，author=' 施 耐 鹿 " }] 


books2:[Book {id=1，name=' 三 国 演义 " ，author=' 罗 嘻 中 '}] 





图 5-9 


5.4.2 ”MyBatis 多 数据 源 


JdbcTemplate 可 以 配置 多 数据 源 ，MyBatis 也 可 以 配置 ， 但 是 步骤 要 稍微 复杂 一 些 。 
1. 准备 工作 


本 案例 使 用 的 数据 库 与 5.4.1 小 节 一 致 ， 这 里 不 再 歼 述 。 创 建 的 项 目 也 和 5.4.1 小 节 一 致 ， 只 
不 过 将 spring-boot-starter-jdbc 依赖 换 成 如 下 MyBatis 依赖 : 





<dependency> 
<groupId>org.mybatis.spring.boot</groupId> 
<artifactId>mybatis-spring-boot-starter</artifactId> 
<version>1.3.2</version> 


MAODP 








</dependency> 


另外 ,application.properties 中 两 个 数据 源 的 配置 ,DataSourceConfig 以 及 Book 实体 类 也 和 5.4.1 
小 节 一 致 ， 这 里 不 资 述 。 同 时 ， 为 了 使 Mapper 映射 文件 不 被 过 滤 掉 ，pom.xml 中 的 配置 与 5.2 节 
中 的 第 6 步 配 置 一 致 
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2. 创建 MyBatis 配置 
配置 MyBatis, 主要 提供 SqlSessionFactory 实例 和 SqlSessionTemplate 实例 ， 代 码 如 下 : 

















1 @Configuration 

@MapperScan (value = "org.sang.mapperl", sqlSessionFactoryRef = 

间 "sqlSessionFactoryBean1") 

4 public class MyBatisConfigOne { 

5 QAutowired 

6 @Qualifier ("dsOne") 

人 DataSource dsOne; 

8 QBean 

9 SqlSessionFactory sqlSessionFactoryBeanl() throws Exception { 
10 SqlSessionFactoryBean factoryBean = new SqlSessionFactoryBean(); 
1 factoryBean.setDataSource (dsOne); 

hb 4 return factoryBean.getObject (); 

13 } 

14 QBean 

15 SqlSessionTemplate sqlSessionTemplatel () throws Exception { 
16 return new SqlSessionTemplate (sqlSessionFactoryBean]l ()); 
17 } 

18 |} 

代码 解释 : 

。 在 @MapperScan 注解 中 指定 Mapper 接口 所 在 的 位 置 , 同时 指定 SqlSessionFactory 的 实例 名 ， 
则 该 位 置 下 的 Mapper 将 使 用 SqlSessionFactory 实例 。 

@ 提供 SqlSessionFactory 的 实例 ， 直 接 创 建 出 来 ， 同 时 将 DataSource 的 实例 设置 给 
SqlSessionFactory ， 这 里 创建 的 SqlSessionFactory 实例 也 就 是 @MapperScan 注解 中 
sqlSessionFactoryRef 参数 指定 的 实例 。 

e@ 提供 一 个 SqlSessionTemplate 实例 。 这 是 一 个 线程 安全 类 ， 主 要 用 来 管理 MyBatis 中 的 
SqlSession 操作 。 

当 MyBatisConfigOne 创建 成 功 后 ， 参 考 MyBatisConfigOne 创建 MyBatisConfigTwo， 代 码 如 

下 : 

1 @Configuration 

2 @MapperScan (value = "org.sang.mapper2", sqlSessionFactoryRef = 

3 "sqlSessionFactoryBean2") 

4 public class MyBatisConfigTwo { 

5 QAutowired 

6 @Qualifier ("dsTwo") 

7 DataSource dsTwo; 

8 QBean 

9 SqlSessionFactory sqlSessionFactoryBean2() throws Exception { 
10 SqlSessionFactoryBean factoryBean = new SqlSessionFactoryBean(); 
Lt factoryBean.setDataSource (dsTwo); 

3 return factoryBean.getObject (); 

和 } 

14 Bean 
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15 SqlSessionTemplate sqlSessionTemplate2() throws Exception { 
16 return new SqlSessionTemplate (sqlSessionFactoryBean2()); 
17 } 

18 |} 








3. 创建 Mapper 


分 别 在 org.sang.mapperl 和 org.sang.mapper2 包 下 创建 两 个 不 同 的 Mapper 以 及 相应 的 Mapper 
映射 文件 ， 代 码 如 下 。 
org.sang.mapperl 中 : 





public interface BookMapper { 

List<Book> getAllBooks (); 
} 
<?xml version="1.0" encoding="UTF-8" ?> 
<!DOCTYPE mapper 

PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 

"http://mybatis.org/dtd/mybatis-3-mapper.dtd"> 
<mapper namespace="org.sang.mapperl .BookMapper"> 
<select id="getAllBooks" resultType="org.sang.model .Book"> 

select * from book; 
</select> 
</mapper> 


FoDDamwmcmwm 
Po 


上 
DL 





org.sang.mapper2 中 : 





public interface BookMapper2 { 
List<Book> getAllBooks (); 


} 
<?xml Version="1.0" encoding="UTF-8" ?> 
<!DOCTYPE mapper 
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-mapper.dtd"> 
<mapper namespace="org.sang.mapper2.BookMapper2"> 
<select id="getAllBooks" resultType="org.sang.model .Book"> 
10 select * from book; 
11 | </select> 
12 | </mapper> 


这 两 个 不 同 的 Mapper 将 操作 不 同 的 数据 源 。 
4. 创建 Controller 
简便 起 见 ， 这 里 直接 将 Mapper 注入 Controller 中 ， 代 码 如 下 : 


@RestController 

public class BookController { 
QAutowired 
BookMapper bookMapper; 
QAutowired 
BookMapper2 bookMapper2; 
Q@GetMapping ("/test1" 
public void test1() { 


虽 oomnnamm 必 wm 











1 
2 
3 
4 
5 
6 
1 
8 
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9 List<Book> books1l = bookMapper .getAllBooks () 
10 List<Book> books2 = bookMapper2 .getAllBooks (); 
项 System.out .println("books1:"+books1); 

12 System.out .println("books2:"+books2) ; 

13 } 

14 |} 








在 Controller 中 注入 两 个 不 同 的 Mapper， 然 后 调用 两 个 Mapper 中 的 查询 方法 。 
5. 测试 


最 后 , 在 浏览 器 中 输入 http://localhost:8080/test1, 即 可 看 到 控制 台 打 印 了 不 同 数 据 库 中 的 数据 ， 
如 图 5-10 所 示 。 





Tue Jul 17 08:10:18 CST 2018 WARN: Establishing SSL co 


booksl :[Bool {id=1，name=' 水 浒 传 ' ，author=' 施 耐 鹿 " }】 
books?2: [Bool {id=1，name=' 三 国 演 义 " ，author=' 罗贯中 '}] 





图 5-10 


5.4.3 ”JPA 多 数据 源 


JPA 和 MyBatis 配置 多 数据 源 类 似 ， 不同 的 是 ，JPA 配置 时 主要 提供 不 同 的 
LocalContainerEntityManagerFactoryBean 以 及 事务 管理 器 ， 有 具体 配置 步骤 如 下 。 

1. 准备 工作 

本 案例 使 用 的 数据 库 与 5.4.1 小 节 一 致 ， 这 里 不 再 歼 述 。 创 建 的 项 目 也 和 5.4.1 小 节 一 致 ， 只 
不 过 将 spring-boot-starter-jdbec 依赖 换 成 如 下 Spring Data JPA 依赖 : 





<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-data-jpa</artifactId> 
</dependency> 


ODP 





application.properties 中 两 个 数据 源 在 原 有 配置 的 基础 上 再 添加 如 下 JPA 相关 的 配置 : 


spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MYSQL57InnoDBDialec 
芷 

spring.jpa.properties.database=mysql 
spring.jpa.properties.hibernate.hbm2ddl1 .auto=update 
spring.jpa.properties.show-sql= true 





AODP 











这 里 的 配置 与 配置 单独 的 JPA 有 区 别 ， 因 为 在 后 文 的 配置 中 要 从 JpaProperties 中 的 


getProperties 方法 中 获取 所 有 JPA 相关 的 配置 ， 因 此 这 里 的 属性 前 级 都 是 
spring.jpa.properties。 
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DataSourceConfig 也 和 5.4.1 小 节 一 致 ， 这 里 不 次 述 。 
2. 创建 实体 类 
在 org.sang.model 包 下 创建 实体 类 User， 代 码 如 下 : 


@Entity (name = "t user" 
public class User { 
@Id 
Q@GeneratedValue (strategy = GenerationType.IDENTITY) 
private Integer id; 
private String name; 
private String gender; 
private Integer age; 
// 省 略 getter/setter 


OCPD 


-» 
o 











根据 实体 类 在 数据 库 中 创建 tuser 表 ， 表 中 的 id 字段 自 增长 。 





3. 创建 JPA 配置 
接 下 来 是 核心 配置 ， 根 据 两 个 配置 好 的 数据 源 创建 两 个 不 同 的 JPA 配置 ， 代 码 如 下 : 
1 @Configuration 
2 @EnableTransactionManagement 
3 @EnableJpaRepositories (basePackages = "org.sang.daol", 
4 entityManagerFactoryRef = "entityManagerFactoryBeanOne", 
5 transactionManagerRef = "platformTransactionManagerOne") 
6 |public class JpaConfigOne { 
7 @Resource (name = "dsOne") 
8 DataSource dsOne; 
9 @Autowired 
10 JpaProperties jpaProperties; 
11 QBean 
于 @Primary 
13 LocalContainerEntityManagerFactoryBean entityManagerFactoryBeanOne( 
14 EntityManagerFactoryBuilder builder) { 
15 return builder.dataSource (dsOne) 
16 .Properties (jpaProperties .getProperties ()) 
好 .packages ("org.sang.model" 
18 .persistenceUnit ("pul" 
9 .build(); 
20 } 
21 QBean 
22 PlatformTransactionManager platformTransactionManagerOne( 
23 EntityManagerFactoryBuilder builder) { 
24 LocalContainerEntityManagerFactoryBean factoryOne = 
25 | entityManagerFactoryBeanOne (builder); 
26 return new JpaTransactionManager (factoryOne.getObject ()); 
27 } 
28 |} 
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代码 解释 : 

@ 使 用 @EnableJpaRepositories 注解 来 进行 JPA 的 配置 ， 该 注解 中 主要 配置 三 个 属性 : 
basePackages、entityManagerFactoryRef 以 及 transactionManagerRef。 其 中 ，basePackages 用 来 
指定 Repository 所 在 的 位 置 ,entityManagerFactoryRef 用 来 指定 实体 类 管理 工厂 Bean 的 名 称 ， 
transactionManagerRef 则 用 来 指定 事务 管理 器 的 引用 名 称 ,这 里 的 引用 名 称 就 是 JpaConfigOne 
类 中 注册 的 Bean 的 名 称 (默认 的 Bean 名 称 为 方法 名 )。 

e 第 13-20 行 创建 LocalContainerEntityManagerFactoryBean, 该 Bean 将 用 来 提供 EntityManager 
实例 ， 在 该 类 的 创建 过 程 中 ， 首 先 配置 数据 源 ， 然 后 设置 JPA 相关 配置 (JpaProperties 由 系 
统 自动 加 载 )， 再 设置 实体 类 所 在 的 位 置 ， 最 后 配置 持久 化 单元 名 ， 若 项 目 中 只 有 一 个 
EntityManagerFactory， 则 persistenceUnit 可 以 省 略 掉 ， 若 有 多 个 ， 则 必须 明确 指定 持久 化 单 
元 名 。 

@ 由 于 项 目 中 会 提供 两 个 LocalContainerEntityManagerFactoryBean 实例 ， 第 12 行 的 注解 
(@Primary 表示 当 存 在 多 个 LocalContainerEntityManagerFactoryBean 实例 时 ,该 实例 将 被 优先 
使 用 。 

e 第 21~27 行 表 示 创 建 一 个 事务 管理 器 。JpaTransactionManager 提供 对 单个 
EntityManagerFactory 的 事务 支持 ， 专 门 用 于 解决 JPA 中 的 事务 管理 。 


这 是 第 一 个 JPA 配置 ， 第 二 个 与 之 类 似 ， 代 码 如 下 : 








1 @Configuration 

过 @EnableTransactionManagement 

3 @EnableJpaRepositories (basePackages = "org.sang.dao2", 

4 entityManagerFactoryRef = "entityManagerFactoryBeanTwo", 

5 transactionManagerRef = "platformTransactionManagerTwo") 

6 |public class JpaConfigTwo { 

7 @Resource (name = "dsTwo") 

8 DataSource dsTwo; 

a @Autowired 

10 JpaProperties jpaProperties; 

es QBean 

地 LocalContainerEntityManagerFactoryBean entityManagerFactoryBeanTwo( 
13 EntityManagerFactoryBuilder builder) { 

14 return builder.dataSource (dsTwo) 

雹 .Properties (jpaProperties .getProperties ()) 

16 .packages ("org.sang.model") 

7 .persistenceUnit ("pu2") 

18 -build(); 

19 } 

20 Q@Bean 

21 PlatformTransactionManager platformTransactionManagerTwo( 
22 EntityManagerFactoryBuilder builder) { 

23 LocalContainerEntityManagerFactoryBean factoryTwo = 
24 | entityManagerFactoryBeanTwo (builder); 

25 return new JpaTransactionManager (factoryTwo.getObject ()); 
26 } 

27 |} 
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JpaConfigTwo 的 配置 与 JpaConfigOne 类 似 ， 注 意 LocalContainerEntityManagerFactoryBean 实 
例 不 需要 添加 @Primary 注解 。 
4. 创建 Repository 


根据 第 3 步 的 配置 ， 分 别 在 org.sang.daol 和 org.sang.dao2 包 下 创建 两 个 Repository。 
UserDao 如 下 : 





package org.sang.daol; 

import org.sang.model .User; 

import org.springframework.data.jpa.repository.JpaRepository; 
public interface UserDao extends JpaRepository<User, Integer>{ 


} 


MODP 





UserDao2 如 下 : 


package org.sang.dao2; 

import org.sang.model.User; 

import org.springframework.data.jpa.repository.JpaRepository; 
public interface UserDao2 extends JpaRepository<User, Integer>{ 
} 

UserDao 和 UserDao2 将 操作 不 同 的 数据 源 。 

5. 创建 Controller 


简便 起 见 ， 这 里 省 略 掉 Service 层 ， 将 UserDao 直接 注入 Controller 中 ， 代 码 如 下 : 











MRODPp 





1 @RestController 

2 public class UserController { 
3 @Autowired 

4 UserDao userDao; 

和 @Autowired 

6 UserDao2 userDao2; 

学 &GetMapping("/test1") 

8 public void test1() { 

9 User ul = new User(); 
10 ul.setAge (55); 

11 ul.setName ("和 鲁迅") ; 

12 ul.setGender (" 男 "); 
3 userDao.save (ul); 

14 User u2 = new User(); 
15 u2.setAge(80); 

16 u2 .setName ("泰戈尔 ") ; 
17 u2.setGender (" 男 ") ; 
18 UserDao2.save (u2); 

19 } 

20 | } 











6. 测试 


在 浏览 器 中 输入 “http://localhost:8080/test1”， 然 后 查看 数据 库 ， 即 可 看 到 数据 库 中 的 表 和 数 
据 都 已 经 存在 了 ， 如 图 5-11 所 示 。 
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本 章 主 要 和 读者 分 享 了 Spring Boot 整合 持久 层 技术 , 包括 JdbcTemplate、MyBatis 以 及 Spring 
Data JPA。 其 中 ，JdbcTemplate 使 用 得 并 不 是 很 广泛 ; MyBatis 灵活 性 较 好 ， 方 便 开 发 者 进行 SQL 
优化 ;Spring Data JPA 使 用 方便 ， 特 别 是 快速 实现 一 个 RESTful 风格 的 应 用 (将 在 第 7 章 向 读者 
介绍 ) 。 


Spring Boot 整合 NoSQL 


本 章 概要 


ee 整合 Redis 
”整合 MongoDB 
@ Session 共享 


NoSQL 是 指 非 关系 型 数据 库 ， 非 关系 型 数据 库 和 关系 型 数据 库 两 者 存在 许多 显著 的 不 同 点 ， 
其 中 最 重要 的 是 NoSQL 不 使 用 SQL 作为 查询 语言 。 其 数据 存储 可 以 不 需要 固定 的 表格 模式 , 一 般 
都 有 水 平 可 扩展 性 的 特征 。NoSQL 主要 有 如 下 几 种 不 同 的 分 类 : 
eKey/Value 键 值 存储 。 这 种 数据 存储 通常 都 是 无 数据 结构 的 ,一 般 被 当 作 字 符 囊 或 者 二 进 制 数 
据 ， 但 是 数据 加 载 速度 快 ， 典 型 的 使 用 场景 是 处 理 高 并 发 或 者 用 于 日 志 系统 等 ， 这 一 类 的 数 
据 库 有 Redis、Tokyo Cabinet 等 。 

ee 列 存 储 数据 库 。 列 存储 数据 库 功 能 相对 局 限 ， 但 是 查找 速度 快 ， 容 易 进行 分 布 式 扩展 ， 一 般 
用 于 分 布 式 文件 系统 中 ， 这 一 类 的 数据 库 有 HBase、Cassandra 等 。 

@ 文档 型 数据 库 。 和 Key/Value 键 值 存储 类 似 ， 文 档 型 数据 库 也 没有 严格 的 数据 格式 ， 这 既是 
缺点 也 是 优势 ， 因 为 不 需要 预先 创建 表 结 构 ， 数 据 格式 更 加 灵活 ， 一 般 可 用 在 Web 应 用 中 ， 
这 一 类 数据 库 有 MongoDB、CouchDB 等 。 

@ 图形 数据 库 。 图 形 数据 库 专注 于 构建 关系 图 谱 ， 例 如 社交 网 络 ， 推 荐 系统 等 ， 这 一 类 的 数据 
库 有 Neo4J、DEX 等 。 


NoSQL 种 类 繁多 ，Spring Boot 对 大 多 数 NoSQL 都 提供 了 配置 支持 ， 本 书 主要 向 读者 介绍 常 
见 的 两 个 :Redis 和 MongoDB。 
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6.1 整合 Redis 





6.1.1 Redis 简介 


Redis 是 一 个 使 用 C 编写 的 基于 内 存 的 NoSQL 数据 库 , 它 是 目前 最 流行 的 键 值 对 存储 数据 库 。 
Redis 由 一 个 Key、Value 映射 的 字典 构成 ， 与 其 他 NoSQL 不 同 ，Redis 中 Value 的 类 型 不 局 限于 
字符 串 ， 还 支持 列表 、 集 合 、 有 序 集合 、 散 列 等 。Redis 不 仅 可 以 当 作 缓存 使 用 ， 也 可 以 配置 数据 
持久 化 后 当 作 NoSQL 数据 库 使 用 ， 目 前 支持 两 种 持久 化 方式 : 快照 持久 化 和 AOF 持久 化 。 另 一 
方面 ，Redis 也 可 以 搭建 集群 或 者 主 从 复制 结构 ， 在 高 并 发 环境 下 具有 高 可 用 性 。 





6.1.2 ”Redis 安装 


Redis 版 本 使 用 写作 本 书 时 的 最 新 版 4.0.10， 安 装 环境 选择 CentOS 7。 安 装 步 又 如 下 。 
1. 下 载 Redis 
首先 执行 如 下 命令 下 载 Redis: 


wget http://download.redis.io/releases/redis-4.0.10.tar.gz 





若 提 示 未 找到 命令 ， 则 先 执行 如 下 命令 安装 wget， 再 下 载 Redis: 
Cminstauwet | 
2. 安装 Redis 

首先 解压 下 载 的 文件 ， 然 后 进入 解压 目录 中 进行 编译 ， 执 行 如 下 4 条 命令 : 





tar -zxvf redis-4.0.10.tar.gz 
cd redis-4.0.10 

make MALLOC=libc 

make install 


必 ww 请 





若 在 执行 make MALLOC=libce 命令 时 提示 “gcc: 未 找到 命令 ”， 则 先 安装 gcc， 命 令 如 下 : 











1 [yam install gcc 
安装 成 功 后 再 进行 编译 安装 。 
3. 配置 Redis 
Redis 安装 成 功 后 ， 接 下 来 进行 配置 ， 打 开 Redis， 解 压 目录 下 的 redis.conf 文件 ， 主 要 修改 如 
下 几 个 地 方 : 


daemonizeyes 
#bind 127.0.0.1 








requirepass 123@456 





Protected-mode no 
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配置 解释 : 

@ 第 1 行 配置 表示 允许 Redis 在 后 台 启 动 。 

@ 第 2 行 配置 表示 允许 连接 该 Redis 实例 的 地 址 ， 默 认 情况 下 只 允许 本 地 连接 ， 将 默认 配置 注 
释 掉 ， 外 网 就 可 以 连接 Redis 了 。 

e@ 第 3 行 配置 表示 登录 该 Redis 实例 所 需 的 密码 。 

@ 由 于 有 了 第 3 行 配置 的 密码 登录 ， 因 此 第 4 行 就 可 以 关闭 保护 模式 了 。 

4. 配置 CentOS 

为 了 能 够 远程 连接 上 Redis， 还 需要 关闭 CentOS 防火 墙 ， 执 行 如 下 命令 : 





1 | systemct1 stop firewalld.service 
2 | systemct1l disable firewalld.service 


其 中 ， 第 1 行 表示 关闭 防火 墙 ， 第 2 行 表示 禁止 防火 墙 开机 启动 。 
5. Redis 启动 与 关闭 
最 后 ， 执 行 如 下 命令 启动 Redis: 





| 1 I redis-server redis.conf | 





Redis 启动 成 功 后 ， 再 执行 如 下 命令 进入 Redis 控制 台 ， 其 中 -a 表示 Redis 登录 密码 : 

进入 控制 台 后 执行 ping 命令 ， 如 果 能 看 到 PONG， 表 示 Redis 安装 成 功 ， 如 图 6-1 所 示 。 

如 果 想 关闭 Redis 实例 , 可 以 在 控制 台 执行 SHUTDOWN, 然后 使 用 exit 退出 (如 图 6-2 所 示 )， 
或 者 直接 在 命令 行 执行 如 下 命令 : 


1 | redis-cli -p 6379 -a 123@456 shutdown 





其 中 ，-p 表示 要 关闭 的 Redis 实例 的 端口 号 ，-a 表示 Redis 登录 密码 。 





至 此 ， 单 机 版 Redis 就 安装 并 启动 成 功 了 。 
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6.1.3 整合 Spring Boot 


Redis 的 Java 客户 端 有 很 多 , 例如 Jedis\ JRedis\ Spring Data Redis 等 ， Spring Boot 借助 于 Spring 
Data Redis 为 Redis 提供 了 开 箱 即 用 自动 化 配置 ， 开 发 者 只 需要 添加 相关 依赖 并 配置 Redis 连接 信 
息 即 可 ， 有 具体 整合 步骤 如 下 。 


1. 创建 Spring Boot 项 目 
首先 创建 Spring Boot Web 项 目 ， 添 加 如 下 依赖 : 


<dependency> 





<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-data-redis</artifactId> 
</dependency> 

<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 
</dependency> 


cammcmwm 





默认 情况 下 ，spring-boot-starter-data-redis 使 用 的 Redis 工具 是 Lettuce， 考 虑 到 有 的 开发 者 习 
惯 使 用 Jedis， 因 此 可 以 从 spring-boot-starter-data-redis 中 排除 Lettuce 并 引入 Jedis， 修 改 为 如 下 依 
赖 : 





<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-data-redis</artifactId> 
<exclusions> 

<exclusion> 

<groupId>io.lettuce</groupId> 
<artifactId>lettuce-core</artifactId> 
</exclusion> 

</exclusions> 

10 | </dependency> 

11 | <dependency> 

12 | <groupId>redis.clients</groupId> 

13 | <artifactId>jedis</artifactId> 

14 | </dependency> 

15 | <dependency> 

16 | <groupId>org.springframework.boot</groupId> 

17 | <artifactId>spring-boot-starter-web</artifactId> 
18 | </dependency> 


2. 配置 Redis 
接 下 来 在 application.properties 中 配置 Redis 连接 信息 ， 代 码 如 下 : 


spring.redis.database=0 
spring.redis.host=192.168.248.144 
spring.redis.port=6379 
spring.redis.password=123@456 


omnammm 必 wm 

















an 必 wm 





spring.redis.jedis.pool.max-active=8 
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6 | spring.redis.jedis.pool.max-idle=8 
7 | spring.redis.jedis.pool.max-wait=-lms 
8 | spring.redis.jedis.pool.min-idle=0 


配置 解释 : 

@ 第 1-4 行 是 基本 连接 信息 配置 ， 第 S-8 行 是 连接 池 信 息 配 置 。 

@ 第 1 行 配置 表示 使 用 的 Redis 库 的 编号 ，Redis 中 提供 了 16 个 database， 编 号 为 0~15。 
@ 第 2 行 配置 表示 Redis 实例 的 地 址 。 

@ 第 3 行 配置 表示 Redis 端口 号 ， 默 认 是 6379。 

e 第 4 行 配置 表示 Redis 登录 密码 。 

第 5 行 配置 表示 Redis 连接 池 的 最 大 连接 数 。 

第 6 行 配置 表示 Redis 连接 池 中 的 最 大 空闲 连接 数 。 

第 7 行 配置 表示 连接 池 的 最 大 阻塞 等 待 时 间 ， 默 认为 -1， 表 示 没 有 限制 。 

第 8 行 配置 表示 连接 池 最 小 空闲 连接 数 。 

如 果 项 目 使 用 了 Lettuce， 则 只 需 将 第 5~8 行 配置 中 的 jedis 修改 为 lettuce 即 可 。 











在 Spring Boot 的 自动 配置 类 中 提供 了 RedisAutoConfiguration 进行 Redis 的 配置 ， 部 分 源码 如 








1 @Configuration 

各 @ConditionalOnClass (RedisOperations.class) 

委 @EnableConfigurationProperties (RedisProperties.class) 
4 @Import ({LettuceConnectionConfiguration.class, JedisConnectionConfiguration.class}) 
5 |public class RedisAutoConfiguration { 

6 @Bean 

畦 @ConditionalOnMissingBean (name = "redisTemplate") 

8 public RedisTemplate<Object, Object> redisTemplate( 
9 

0 | 

11 | return template; 

| 

13 | @Bean 

14 | @ConditionalOnMissingBean 

15 | public StringRedisTemplate stringRedisTemplate( 

16 

好 

18 | return template; 

19 | } 

20 | } 








由 这 一 段 源码 可 以 看 到 ，application.properties 中 配置 的 信息 将 被 注入 RedisProperties 中 ,如 果 
开发 者 自己 没有 提供 RedisTemplate 或 者 StringRedisTemplate 实例 , 则 Spring Boot 默认 会 提供 这 两 
个 实例 ，RedisTemplate 和 StringRedisTemplate 实例 则 提供 了 Redis 的 基本 操作 方法 。 

3. 创建 实体 类 

创建 一 个 Book 类 ， 代 码 如 下 : 





112 | Spring Boot+Vue 全 栈 开 发 实战 








public class Book implements Serializable { 
Private Integer id; 
Private String name; 
private String author; 
// 省 略 getter/setter 








ao 上 wm 


} 
4. 创建 Controller 
创建 BookController 进行 测试 : 


Q@RestController 
public class BookController { 

Q@Autowired 

RedisTemplate redisTemplate; 

QAutowired 

StringRedisTemplate stringRedisTemplate; 

@GetMapping ("/test1") 

public void test1() { 
ValueOperations<String, String> opsl = stringRedisTemplate.opsForValue(); 
opsl.set ("name", ". ms 
String name = opsl.get ("name"); 
System.out .println (name); 
ValueOperations ops2 = redisTemplate.opsForValue(); 
Book bl = new Book(); 
bl.setId(1); 
bl.setName ("红楼 梦 ") ; 
b1.setAuthor (" 曹 雪 芹 ") ; 
ops2.set ("bl", bl1); 
Book book = (Book) ops2.get ("bl1"); 
System.out .println (book); 








omammmwmn 








onermwhr po 


DD 
=] 








Re 
DN 





代码 解释 : 


® StringRedisTemplate 是 RedisTemplate 的 子 类 , StringRedisTemplate 中 的 key 和 value 都 是 字符 
串 ， 采 用 的 序列 化 方案 是 StringRedisSerializer， 而 RedisTemplate 则 可 以 用 来 操作 对 象 ， 
RedisTemplate 采用 的 序列 化 方案 是 JdkSerializationRedisSerializer, 无 论 是 StingRedisTemplate 
还 是 RedisTemplate， 操 作 Redis 的 方法 都 是 一 致 的 。 

® StringRedisTemplate 和 RedisTemplate 都 是 通过 opsForValue、opsForZSet 或 者 opsForSet 等 方 
法 首先 获取 一 个 操作 对 象 ， 再 使 用 该 操作 对 象 完成 数据 的 读 写 。 

日 第 10 行 向 Redis 中 存储 一 条 记录 , 第 11 行将 之 读 取出 来 。 第 18 行 向 Redis 中 存储 一 个 对 象 ， 
第 19 行将 之 读 取出 来 。 

5. 测试 

在 浏览 器 中 输入 http://localhost:8080/test1， 可 看 到 控制 打印 日 志 如 图 6-3 所 示 。 
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Book {id=1，name=' 红楼 梦 ' ，author=' 曹 雪 片 "} 





图 6-3 


6.1.4 Redis 集群 整合 Spring Boot 


前 文 向 读者 介绍 了 单个 Redis 实例 整合 Spring Boot, 在 实际 项 目 中 ,开发 者 为 了 提高 Redis 的 
扩展 性 ， 往 往 需 要 搭建 Redis 集群 ， 这 样 就 会 涉及 Redis 集群 整合 Spring Boot， 接 下 来 看 看 这 个 问 
题 。 

1. 搭建 Redis 集群 

(1) 集群 原理 

在 Redis 集群 中 , 所 有 的 Redis 节点 彼此 互联 , 节点 内 部 使 用 二 进 制 协议 优化 传输 速度 和 带宽 。 
当 一 个 节点 挂 掉 后 ， 集 群 中 超过 半数 的 节点 检测 失效 时 才 认 为 该 节点 已 失效 。 不 同 于 Tomcat 集群 
需要 使 用 反 向 代理 服务 器 ，Redis 集群 中 的 任意 节点 都 可 以 直接 和 Java 客户 端 连接 。Redis 集群 上 
的 数据 分 配 则 是 采用 哈 希 槽 (HASH SLOT) ，Redis 集群 中 内 置 了 16384 个 哈 希 槽 ， 当 有 数据 需要 
存储 时 ，Redis 会 首先 使 用 CRC16 算法 对 key 进行 计算 , 将 计算 获得 的 结果 对 16384 取 余 ， 这 样 每 
一 个 key 都 会 对 应 一 个 取 值 在 0~16383 之 间 的 哈 希 槽 ，Redis 则 根据 这 个 余数 将 该 条 数据 存储 到 对 
应 的 Redis 节点 上 ， 开 发 者 可 根据 每 个 Redis 实例 的 性 能 来 调整 每 个 Redis 实例 上 哈 希 槽 的 分 布 范 
围 。 

(2) 集群 规划 

本 案例 在 同一 台 服 务 器 上 用 不 同 的 端口 表示 不 同 的 Redis 服务 器 〈 伪 分 布 式 集群 ) 。 

主 节 点 : 192.168.248.144:8001，192.168.248.144:8002，192.168.248.144:8003 。 

从 节点 : 192.168.248.144:8004，192.168.248.144:8005，192.168.248.144:8006 。 

(3) 集群 配置 

Redis 集群 管理 工具 redis-trib.rb 依赖 Ruby 环境 , 首先 需要 安装 Ruby 环境 , 由 于 CentOS 7 yum 
库 中 默认 的 Ruby 版 本 较 低 ， 因 此 建议 采用 如 下 步骤 进行 安装 。 

首先 安装 RVM，RVM 是 一 个 命令 行 工具 ， 可 以 提供 一 个 便捷 的 多 版 本 Ruby 环境 的 管理 和 
切换 ， 安 装 命令 如 下 : 


1 | gpg2 --keyserver hkp://keys.gnupg.net --recv-keys D39DCOE3 
2 |curl -L get.rwm.io | bash -s stable 











3 | source /usr/local/rvm/scripts/rwm 


最 后 一 条 命令 表示 安装 完 后 使 RVM 名 生效 ，RVM 安装 成 功 后， 查看 RVM 中 有 哪些 Ruby: 














让 | rvm list known 


查看 结果 如 图 6-4 所 示 。 
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选择 最 新 的 稳定 版 进行 安装 ， 命 令 如 下 : 
是 rvm install 2.5.1 
最 后 安装 Redis 依赖 ， 命 令 如 下 : 
[Taen instattreds | 
接 下 来 创建 redisCluster 文件 夹 ， 将 6.1.2 节 中 下 载 的 Redis 压缩 文件 复制 到 redisCluster 文件 
夹 中 之 后 编译 安装 ， 操 作 命 令 如 下 : 














mkdir redisCluster 

cp -f ./redis-4.0.10.tar.gz ./redisCluster/ 
cd redisCluster 

tar -zxvf redis-4.0.10.tar.gz 

cd redis-4.0.10 

make MALLOC=libc 


ammwmP 


make install 





安装 成 功 后 ， 将 redis-4.0.10/src 目录 下 的 redis-trib.rb 文件 复制 到 redisCluster 目录 下 ， 命 令 如 
下 2 


1 | cp -f ./redis-4.0.10/src/redis-trib.rb ./ 














然后 在 redisCluster 目录 下 创建 6 个 文件 夹 , 分 别 命名 为 8001、8002、8003、8004、8005、8006， 
再 将 redis-4.0.10 目录 下 的 redis.conf 文件 分 别 往 这 6 个 目录 中 复制 一 份 ， 然 后 对 每 个 目录 中 的 
redis.conf 文件 进行 修改 ， 以 8001 目录 下 的 redis.conf 文件 为 例 ， 主 要 修改 如 下 配置 : 





port 8001 

#bind 127.0.0.1 

cluster-enabled yes 
cluster-config-file nodes-8001.conf 
protected no 

daemonize yes 

requirepass 123Q@456 

masterauth 123@456 


2 
2 
3 
4 
5 
6 
2 
8 
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这 里 的 配置 在 6.1.2 小 节 的 单机 版 安装 配置 的 基础 上 增加 了 几 条 ， 其 中 端口 修改 为 8001， 
cluster-enabled 表示 开启 集群 ，cluster-config-file 表示 集群 节点 的 配置 文件 ， 由 于 每 个 节点 都 开启 了 
密码 认证 ， 因 此 又 增加 了 masterauth 配置 ， 使 得 从 机 可 以 登录 到 主机 上 。 按 照 这 里 的 配置 ， 对 
8002~8006 目录 中 的 redis.conf 文件 依次 进行 修改 , 注意 修改 时 每 个 文件 的 port 和 cluster-config-file 
不 一 样 。 全 部 修改 完成 后 ， 进 入 redis-4.0.10 目录 下 ， 分 别 启动 6 个 Redis 实例 ， 相 关 命 令 如 下 : 


redis-server ../8001/redis.conf 
redis-server ../8002/redis.conf 
redis-server ../8003/redis.conf 


redis-server ../8004/redis.conf 
redis-server ../8005/redis.conf 
redis-server ../8006/redis.conf 


当 6 个 Redis 实例 都 启动 成 功 后 , 回 到 redisCluster 目录 下 , 首先 对 redis-trib.rb 文件 进行 修改 ， 
由 于 配置 了 密码 登录 ， 而 该 命令 在 执行 时 默认 没有 密码 ， 因 此 将 登录 不 上 各 个 Redis 实例 ， 此 时 用 
vi 编辑 器 打开 redis-trib.rb 文件 ， 搜 索 到 如 下 一 行 : 


:port => @info[:port], :timeout => 60) 




















er = Redis.new(:host => @info[:host], :port => @info[:port], :timeout => 
60, :password=>"123@456") 

123@456 就 是 各 个 Redis 实例 的 登录 密码 。 

这 些 配置 都 完成 后 ， 接 下 来 就 可 以 创建 Redis 集群 了 。 
(4) 创建 集群 

执行 如 下 命令 创建 Redis 集群 : 


./redis-trib.rb create --replicas 1 192.168.248.144:8001 192.168.248.144:8002 





192.168.248.144:8003 192.168.248.144:8004 192.168.248.144:8005 192.168.248.144:8006 





其 中 ，replicas 表示 每 个 主 节点 的 slave 数量 。 在 集群 的 创建 过 程 中 会 分 配 主机 和 从 机 ， 每 个 
集群 在 创建 过 程 中 都 将 分 配 到 一 个 唯一 的 id 并 分 配 到 一 段 slot。 

当 集群 创建 成 功 后 ， 进 入 redis-4.0.10 目录 中 ， 登 录 任 意 Redis 实例 ， 命 令 如 下 : 
[LTrzedis-cli 了 sol-a1l2e6 | 

-p 表示 要 登录 的 集群 的 端口 ，-a 表示 要 登录 的 集群 的 密码 ，-c 则 表示 以 集群 的 方式 登录 。 登 
录 成 功 后 ， 通 过 cluster info 命令 可 以 查询 集群 状态 信息 (如 图 6-5 所 示 ) ， 通 过 cluster nodes 命令 
可 以 查询 集群 节点 信息 (如 图 6-6 所 示 ) ， 在 集群 节点 信息 中 ， 可 以 看 到 每 一 个 节点 的 id， 该 节点 
是 slave 还 是 master, 如 果 是 slave, 那么 它 的 master 的 id 是 什么 , 如 果 是 master, 那么 每 一 个 master 
的 slot 范围 是 多 少 ， 这 些 信息 都 会 显示 出 来 。 

(5) 添加 主 节点 

当 集 群 创建 成 功 后 ， 随 着 业务 的 增长 ， 有 可 能 需要 添加 主 节点 ， 添 加 主 节点 需要 先 构建 主 节 
点 实例 ， 将 redisCluster 目录 下 的 8001 目录 再 复制 一 份 ， 名 为 8007， 根 据 第 3 步 的 集群 配置 修改 
8007 目录 下 的 redis.conf 文件 ， 修 改 完成 后 ， 在 redis-4.0.10 目录 下 运行 如 下 命令 启动 该 节点 : 
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图 6-5 








h | redis-server ../8007/redis.conf 





启动 成 功 后 ， 进 入 redisCluster 目录 下 ， 执 行 如 下 命令 将 该 节点 添加 到 集群 中 : 





1 ./redis-trib.rb add-node 192.168.248.144:8007 192.168.248.144:8001 














中 间 的 参数 是 要 添加 的 Redis 实例 地 址 ， 最 后 的 参数 是 集 
-个 Redis 实例 ， 查 看 集群 节点 信息 ， 就 可 以 看 到 该 实例 已 经 


# 中 的 实例 。 添 加 成 功 后 ， 登 录 任 意 
加 进 集群 了 ， 如 图 6-7 所 示 。 









第 6 章 Spring Boot 整 合 NoSQL | 117 








可 以 看 到 ， 新 实例 已 经 被 添加 进 集群 中 ， 但 是 由 于 slot 已 经 被 之 前 的 实例 分 配 完 了 ， 新 添加 
的 实例 没有 slot， 也 就 意味 着 新 添加 的 实例 没有 存储 数据 的 机 会 ， 此 时 需要 从 另外 三 个 实例 中 拿 出 
-部 分 slot 分 配给 新 实例 ， 有 具体 操作 如 下 。 
首先 ， 在 redisCluster 目录 下 执行 如 下 命令 对 slot 重新 分 配 : 





1 ./redis-trib.rb reshard 192.168.248.144:8001 





第 二 个 参数 表示 连接 集群 中 的 任意 一 个 实例 。 
在 执行 命令 的 过 程 中 ， 有 三 个 核心 配置 需要 手动 配置 ， 如 图 6-8 所 示 。 








人 
id 在 节 加 成 功 后 就 可 以 看 到 ， 也 可 以 进入 集群 控制 台 后 利用 cluster nodes 命令 查看 。 

第 三 个 配置 是 这 1000 个 slot 由 哪个 实例 出 ， 例 如 从 端口 为 8001 的 实例 中 拿 出 1000 个 slot 分 
配给 端口 为 8007 的 实例 ， 那 么 这 里 输入 8001 的 id 后 按 回 车 键 ， 再 输入 done 按 回 车 键 即 可 ， 如 果 
想 将 1000 个 slot 均 挫 到 原 有 的 所 有 实例 中 ， 那 么 这 里 输入 all 按 回 车 键 即 可 。 

slot 分 配 成 功 后 ， 再 查看 节点 信息 ， 就 可 以 看 到 新 实例 也 有 slot 了 ， 如 图 6-9 所 示 。 








图 6-9 


(6) 添加 从 节点 
上 面 添加 的 节点 是 主 节 点 ， 从 节点 的 添加 相对 要 容易 一 些 。 添 加 从 节点 的 步骤 如 下 : 





首先 将 redisCluster 目录 下 的 8001 目录 复制 一 份 ， 命 名 为 8008， 然 后 按照 6.1.2 小 节 中 第 3 步 
的 配置 修改 8008 目录 下 的 redis.conf， 修 改 完成 后 ， 启 动 该 实例 ， 然 后 输入 如 下 命令 添加 从 节点 : 
灿 ./redis-trib.rb add-node --slave --master-id 


e0f2751b46c9ed3cal30e9fc825540386feaafb2 192.168.248.144:8008 192.168.248.144:8001 
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添加 从 节点 需要 指定 该 从 节点 的 masterid, --master-id 后 面 的 参数 即 表示 该 从 节点 master 的 id， 
192.168.248.144:8008 表示 从 节点 的 地 址 , 192.168.248.144:8001 则 表示 集群 中 任意 一 个 实例 的 地 址 。 
当 从 节点 添加 成 功 后 ， 登 录 集 群 中 任意 一 个 Redis 实例 ， 通 过 cluster nodes 命令 就 可 以 看 到 从 节点 
的 信息 ， 如 图 6-10 所 示 。 








图 6-10 


(7) 删除 节点 
如 果 删 除 的 是 一 个 从 节点 ， 直 接 运行 如 下 命令 即 可 删除 : 


./redis-trib.rb del-node 192.168.248.144:8001 





122b2098df746afc3a77beddaad85630bf75ab9a 


中 间 的 实例 地 址 表示 集群 中 的 任意 一 个 实例 ， 最 后 的 参数 表示 要 删除 节点 的 id。 但 车 删除 的 
节点 占有 slot， 则 会 删除 失败 ， 此 时 按照 第 5 步 提 到 的 办 法 ， 先 将 要 删除 节点 的 slot 全 部 都 分 配 出 
去 ， 然 后 运行 如 上 命令 就 可 以 成 功 删 除 一 个 占有 slot 的 节点 了 。 

2. 配置 Spring Boot 

不 同 于 单机 版 Redis 整合 Spring Boot，Redis 集群 整合 Spring Boot 需要 开发 者 手动 配置 , 配置 
步骤 如 下 。 

(1) 创建 Spring Boot 项 目 
首先 创建 一 个 Spring Boot Web 项 目 ， 添 加 如 下 依赖 : 





<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 
</dependency> 

<dependency> 
<groupId>redis.clients</groupId> 
<artifactId>jedis</artifactId> 
</dependency> 

<dependency> 

10 | <groupId>org.springframework.data</groupId> 
11 | <artifactId>spring-data-redis</artifactId> 
12 | </dependency> 


omDmamm 必 wm 
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13 | <dependency> 
14 | <groupId>org.apache.commons</groupId> 
15 | <artifactId>commons-pool2</artifactId> 
16 | </dependency> 














(2) 配置 集群 信息 
由 于 集群 节点 有 多 个 ， 可 以 保存 在 一 个 集合 中 ， 因 此 这 里 的 配置 文件 使 用 YAML 格式 的 ， 删 
除 resources 目录 下 的 application.properties 文件 ， 创 建 application.yml 配置 文件 (YAML 配置 可 以 
参考 2.7 节 ) ， 文 件 内 容 如 下 : 











1 spring: 

2 redis: 

EF | cluster: 

4 ports: 

- 8001 

6 - 8002 

了 - 8003 

8 - 8004 

9 - 8005 

10 - 8006 

11 - 8007 

12 - 8008 

13 host: 192.168.248.144 
14 poolConfig: 

15 max-total: 8 

16 max-idle: 8 

17 max-wait-millis: -1 
18 min-idle: 0 


由 于 本 案例 Redis 实例 的 host 都 是 一 样 的 ， 因 此 这 里 配置 了 一 个 host， 而 port 配置 成 了 一 个 
合 ， 这 些 port 将 被 注入 一 个 集合 中 。poolConfig 则 是 基本 的 连接 池 信 息 配置 。 
(3) 配置 Redis 
创建 RedisConfig， 完 成 对 Redis 的 配置 ， 代 码 如 下 : 








和 @Configuration 

2 @ConfigurationProperties ("spring.redis.cluster") 

3 public class RedisConfig { 

4 List<Integer> ports; 

5 String host; 

6 JedisPoolConfig poolConfig; 

可 Bean 

8 RedisClusterConfiguration redisClusterConfiguration() { 

9 RedisClusterConfiguration configuration = new RedisClusterConfiguration(); 
10 List<RedisNode> nodes = new ArrayList<>(); 

WE for (Integer port : ports) { 

1 nodes.add (new RedisNode (host, port)); 

13 ’ 

14 configuration.setPassword (RedisPassword.of ("123@456")); 
15 configuration.setClusterNodes (nodes); 

16 return configuration; 
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17 } 

18 | GBean 

19 | JedisConnectionFactory jedisConnectionFactory() { 

20 | JedisConnectionFactory factory = new 

21 | JedisConnectionFactory (redisClusterConfiguration(),poolConfig); 

22 return factory; 

23 1} 

24 | @Bean 

25 | RedisTemplate redisTemplate() { 

26 RedisTemplate redisTemplate = new RedisTemplate(); 

省 redisTemplate.setConnectionFactory (jedisConnectionFactory ()); 

28 redisTemplate.setKeySerializer (new StringRedisSerializer()); 

29 redisTemplate.setValueSerializer (new JdkSerializationRedisSerializer()); 
30 return redisTemplate; 

31 | } 

32 | @Bean 

33 | StringRedisTemplate stringRedisTemplate() { 

34 StringRedisTemplate stringRedisTemplate = new 

35 | StringRedisTemplate (jedisConnectionFactory()); 

36 stringRedisTemplate.setKeySerializer (new StringRedisSerializer()); 
37 stringRedisTemplate.setKeySerializer (new StringRedisSerializer()); 
38 return stringRedisTemplate; 

391} 

40 | // 省 略 getter/setter 

41 | } 





代码 解释 : 


e 通过 @ConfigurationProperties 注解 声明 配置 文件 前 级 ， 配 置 文件 中 定义 的 ports 数组 、host 以 
及 连接 池 配 置信 息 都 将 被 注入 port、host、poolConfig 三 个 属性 中 。 

ee 配置 RedisClusterConfiguration 实例 ， 设 置 Redis 登录 密码 以 及 Redis 节点 信息 。 

@ 根据 RedisClusterConfiguration 实例 以 及 连接 池 配 置信 息 创建 Jedis 连接 工厂 
JedisConnectionFactory。 

e@ ”根据 JedisConnectionFactory 创建 RedisTemplate 和 StringRedisTemplate, 同时 配置 key 和 value 
的 序列 化 方式 。 有 了 RedisTemplate 和 StringRedisTemplate， 剩 下 的 用 法 就 和 单 实 例 的 用 法 一 
到 了 予 。 


(4) 创建 Controller 
创建 Controller 和 Book 实例 ， 代 码 如 下 : 


public class Book implements Serializable { 
private String name; 
private String author; 
// 省 上 getter/setter 





} 

@RestController 

public class BookController { 
QAutowired 
RedisTemplate redisTemplate; 








OCODNPp 
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10 QRAutowired 

11 StringRedisTemplate stringRedisTemplate; 

12 Q@GetMapping ("/test1") 

i | public void test1() { 

14 ValueOperations ops = redisTemplate.opsForValue(); 
区 Book book = new Book(); 

16 book.setName ("水 浒 传 ") ; 

33 book.setRuthor (" 施 耐 唐 ") ; 

18 ops.set ("bl", book); 

19 System.out .println(ops.get ("b1")); 

20 ValueOperations<String, String> ops2 = stringRedisTemplate.opsForValue(); 
21 ops2.set ("kl", "v1"); 

22 System.out .println(ops2.get ("k1")); 











测试 Controller 与 单 实例 Redis 测试 Controller 基本 一 致 。 创建 完成 后 , 启动 Spring Boot 项 目 。 
(5) 测试 
最 后 ， 在 浏览 器 中 输入 http://localhost:8080/test1， 控 制 台 打印 日 志 如 图 6-11 所 示 。 





2018-07-18 22:39:05.878 INF0 13284 
Book {name=" 水 浒 传 ' ，author=' 施 耐 广 ”) 
vl 





图 6-11 


然后 登录 任意 一 个 Redis 实例 ， 查 询 数据 ， 结 果 如 图 6-12 所 示 。 





由 图 6-12 的 日 志 可 以 看 到 ， 查 询 时 只 需要 登录 任意 一 个 Redis 实例 ，RedisCluster 会 负责 将 查 
询 请 求 Redirected 到 相应 的 实例 上 去 。 


6.2 整合 MongoDB 


6.2.1 MongoDB 简介 














MongoDB 是 一 种 面向 文档 的 数据 库 管 理 系统 ， 它 是 一 个 介 于 关系 型 数据 库 和 非 关 系 型 数据 库 
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之 间 的 产品 ，MongoDB 功能 丰富 ， 它 支持 一 种 类 似 JSON 的 BSON 数据 格式 ， 既 可 以 存储 简单 的 
数据 格式 ， 也 可 以 存储 复杂 的 数据 类 型 。MongoDB 最 大 的 特点 是 它 支 持 的 查询 语言 非常 强大 ， 并 
且 还 支持 对 数据 建立 索引 。 总 体 来 说 ，MongoDB 是 一 款 应 用 相当 广泛 的 NoSQL 数据 库 。 


6.2.2 MongoDB 安装 


本 案例 使 用 的 MongoDB 版 本 为 写作 本 书 时 的 最 新 版 本 4.0.0， 安 装 环境 为 CentOS 7。 安 装 步 
又 如 下 。 

1. 下 载 MongoDB 

首先 执行 如 下 命令 下 载 MongoDB: 


wget https://fastdl.mongodb.org/linux/mongodb-linux-x86 64-4.0.0.tgz 


下 载 完成 后 , 将 下 载 的 MongoDB 解压 ， 并 将 解压 后 的 文件 夹 重 命名 为 mongodb， 执 行 命令 如 








tar -zxvf mongodb-linux-x86 64-4.0.0.tgz 
mv mongodb-linux-x86 64-4.0.0 mongodb 





2. 配置 MongoDB 
进入 mongodb 目录 下 ， 创 建 两 个 文件 夹 db 和 logs， 分 别 用 来 保存 数据 和 日 志 ， 代 码 如 下 : 


1 |cd mongodb 
2 | mkdir db 
3 | mkdir logs 


然后 进入 bin 目录 下 ， 创 建 一 个 新 的 MongoDB 配置 文件 mongo.conf， 文 件 内 容 如 下 : 





dbpath=/opt/mongodb/db 
logpath=/opt/mongodb/10gs/mongodb.1og 
port=27017 

fork=true 





AODP 








配置 解释 : 
e 第 1 行 配置 表示 数据 存储 目录 。 
e 第 2 行 配置 表示 日 志文 件 位 置 。 
e 第 3 行 配置 表示 启动 端口 。 
@ 第 4 行 配置 表示 以 守护 程序 的 方式 启动 MongoDB， 即 允许 MongoDB 在 后 台 运 行 。 
3. MongoDB 的 启动 和 关闭 
配置 完成 后 ， 还 是 在 bin 目录 下 ， 运 行 如 下 命令 启动 MongoDB: 
1 ./mongod -f mongo.conf --bind ip all 
二 表示 指定 配置 文件 的 位 置 , --bind_ip_all 则 表示 允许 所 有 的 远程 地 址 连接 该 MongoDB 实例 。 
MongoDB 启动 成 功 后 ， 在 bin 目录 下 再 执行 mongo 命令 ， 进 入 MongoDB 控制 台 ， 然 后 输入 
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db.version()， 如 果 能 看 到 MongoDB 的 版 本 号 ， 就 表示 安装 成 功 : 





1 | ./mongo 
& db.version() 


安装 成 功 的 界面 如 图 6-13 所 示 。 


图 6-13 





默认 情况 下 ， 启 动 后 连接 的 是 MongoDB 中 的 test 库 ， 而 关闭 MongoDB 的 命令 需要 在 admin 
库 中 执行 ， 因 此 关闭 MongoDB 需要 首先 切换 到 admin 库 ， 然 后 执行 db.shutdownServer0: 命 令 ， 完 
整 操作 步骤 如 下 : 
1 | use admin; 
4 db.shutdownServer () 7 
3 | exit 
服务 关闭 后 , 执行 exit 命令 退出 控制 台 , 此 时 如 果 再 执行 .mongo 命令 就 会 执行 失败 , 如 图 6-14 
所 示 。 





图 6-14 


4. 安全 管理 

默认 情况 下 ,启动 的 MongoDB 没有 登录 密码 ,在 生产 环境 中 这 是 非常 不 安全 的 , 但 是 不 同 于 
MySQL、Oracle 等 关系 型 数据 库 ，MongoDB 中 每 一 个 库 都 有 独立 的 密码 ， 在 哪 一 个 库 中 创建 用 户 
就 要 在 哪 一 个 库 中 验证 密码 。 要 配置 密码 , 首先 要 创建 一 个 用 户 , 例如 在 admin 库 中 创建 一 个 用 户 ， 
代码 如 下 : 


1 | use admin; 
2 db.createUser ({user:"sang",pwd:"123", roles: [{role:"readWrite", db:"test"}]}) 
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新 创建 的 用 户 名 为 sang， 密 码 是 123，roles 表示 该 用 户 具有 的 角色 ， 这 里 的 配置 表示 该 用 户 
对 test 库 具 有 读 和 写 两 项 权限 。 
用 户 创建 成 功 后 ， 关 闭 当前 实例 ， 然 后 重新 启动 ， 启 动 命令 如 下 : 


1 | ./mongod -f mongo.conf --auth --bind ip all 

















启动 成 功 后 , 再 次 进入 控制 台 , 然后 切换 到 admin 库 中 验证 登录 (默认 连接 上 的 库 是 test 库 ) ， 
验证 成 功 后 就 可 以 对 test 库 执行 读 写 操作 了 ， 代 码 如 下 : 


1 | ./mongo 
这 db.auth ("sang", "123") 











如 果 db.auth("sang","123") 命 令 执行 结果 为 1, 就 表示 认证 成 功 , 可 以 执行 对 test 库 的 读 写 操作 。 
6.2.3 整合 Spring Boot 


借助 于 Spring Data MongoDB, Spring Boot 为 MongoDB 也 提供 了 开 箱 即 用 的 自动 化 配置 方案 ， 
具体 配置 步骤 如 下 。 


1. 创建 Spring Boot 工程 
创建 Spring Boot Web 工程 ， 添 加 MongoDB 依赖 ， 代 码 如 下 : 


<dependency> 

<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-data-mongodb</artifactId> 
</dependency> 

<dependency> 

<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 
</dependency> 


2. 配置 MongoDB 





在 application.properties 中 配置 MongoDB 的 连接 信息 ， 代 码 如 下 : 





spring.data.mongodb.authentication-database=admin 
spring.data.mongodb.database=test 
spring.data.mongodb.host=192.168.248.144 
spring.data.mongodb.port=27017 
spring.data.mongodb.username=sang 
spring.data.mongodb.password=123 





ao 必 w 








配置 解释 : 


e 第 1 行 配置 表示 验证 登录 信息 的 库 。 
e 第 2 行 配置 表示 要 连接 的 库 ， 认 证 信息 不 一 定 要 在 连接 的 库 中 创建 ， 因 此 这 两 个 分 开 配 置 。 
@ 第 3-~6 行 配置 表示 MongoDB 的 连接 地 址 和 认证 信息 等 。 
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3. 创建 实体 类 
创建 实体 类 Book， 代 码 如 下 : 


public class Book{ 
private Integer id; 
private String name; 
private String author; 
// 省 略 getter/setter 





ao 性 





4. 创建 BookDao 
BookDao 的 定义 类 似 于 Spring Data JPA 中 的 Repository 定义 ， 代 码 如 下 : 








public interface BookDao extends MongoRepository<Book, Integer> { 
List<Book> findByAuthorContains (String author) 
Book findByNameEquals (String name); 


性 wm 








MongoRepository 中 已 经 预定 义 了 针对 实体 类 的 查询 、 添 加 、 删 除 等 操作 。BookDao 中 可 以 按 
照 5.3 节 提 到 的 方法 命名 规则 定义 查询 方法 。 

5. 创建 Controller 

简单 起 见 ， 直 接 将 BookDao 注入 Controller 进行 测试 : 





1 @RestController 

和 public class BookController { 

| @Autowired 

4 BookDao bookDao; 

5 @GetMapping ("/test1") 

6 public void test1() { 

时 List<Book> books = new ArrayList<>(); 
8 Book bl = new Book(); 

9 bl.setId(1); 

10 bl1.setName (" 朝 花 夕 拾 ") ; 

11 bl1.setAuthor ("鲁迅 "); 

12 books.add (b1); 

13 Book b2 = new Book(); 

14 b2.setId(2); 

15 b2 .setName ("呐喊 ") ; 

16 b2.setAuthor ("鲁迅 ") ; 

Lr books.add (b2); 

18 bookDao. insert (books); 

19 List<Book> booksl = bookDao.findByAuthorContains ("鲁迅 "); 
20 System.out .println (books1); 

21 Book book = bookDao.findByNameEquals(" 朝 花 夕 拾 "); 
22 System.out .println (book); 

23 } 

24 1} 
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代码 解释 : 

@ 第 18 行 调用 MongoRepository 中 的 insert 方法 插入 集合 中 的 数据 。 

e 第 19 行 表示 查询 作者 名 字 中 包含 “鲁迅 ”的 所 有 书 。 

e 第 21 行 表示 查询 书 名 为 “ 朝 花 夕 拾 ”的 图 书信 息 。 

6. 测试 BookDao 

创建 好 Controller 后 ， 在 浏览 器 中 输入 http://localhost:8080/test1， 控 制 台 打印 日 志 如 图 6-15 
所 示 。 





[Book {id=1，name=' 朝 花 儿 拾 ' ，author=' 鲁迅 '}，Book: {id=2?，name=' 呐喊 '"，author=' 鲁迅 '}] 
Book {id=1，name=' 朝 花 夕 抬 ' ，author= "鲁迅 } 





图 6-15 


此 时 登录 MongoDB 服务 器 ， 认 证 身份 后 ， 在 test 库 中 即 可 查询 到 刚刚 插入 的 数据 ， 如 图 6-16 
所 示 。 





图 6-16 
7. 使 用 MongoTemplate 
除了 继承 MongoRepository 外 ，Spring Data MongoDB 还 提供 了 MongoTemplate 用 来 方便 地 操 
作 MongoDB。 在 Spring Boot 中 ， 若 添加 了 MongoDB 相关 的 依赖 ， 而 开发 者 并 没有 提供 
MongoTemplate， 则 默认 会 有 一 个 MongoTemplate 注册 到 Spring 容器 中 ， 相 关 配 置 源码 在 
MongoDataAutoConfiguration 类 中 。 因 此 ， 用 户 可 以 直接 使 用 MongoTemplate， 在 Controller 中 直 
接 注入 MongoTemplate 就 可 以 使 用 了 ， 添 加 如 下 代码 到 第 5 步 的 Controller 中 : 

















@Autowired 


于 
2 MongoTemplate mongoTemplate; 

3 @GetMapping ("/test2") 

4 public void test2() { 

5 List<Book> books = new ArrayList<>(); 
6 Book bl = new Book(); 

了 bl.setId(3) 

8 bl .setName (" 围 城 ") ; 

9 bl.setRAuthor (" 钱 钟 书 ") ; 

10 books .add (bl1) 

了 全 Book b2 = new Book() 
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12 b2.setId(4) 
13 b2 . setName (" 宋 诗 选 注 ") ; 
14 b2.setRAuthor (" 钱 钟 书 ") ; 
15 books .add (b2); 
16 mongoTemplate.insertAll (books); 
17 List<Book> list = mongoTemplate.findAll]l (Book.class); 
18 System.out.println (list); 
19 Book book = mongoTemplate.findById(3, Book.class); 
20 System.out.println (book); 
21 |} 
代码 解释 : 


e 第 1、2 行 表示 注入 Spring Boot 提供 的 MongoTemplate。 
e 第 16 行 表示 向 MongoDB 中 插入 一 个 集合 。 

日 第 17 行 表示 查询 book 集合 中 的 所 有 数据 。 

e 第 19 行 表示 根据 id 查询 一 个 文档 。 


最 后 ， 在 浏览 器 中 输入 http://localhost:8080/test2， 控 制 台 打印 日 志 如 图 6-17 所 示 。 


[Book {id=1，name=' 朝 蓄 夕 拾 " ，author=' 鲁迅 '}，Book {id=2，name=' 呐喊"，author=' 鲁迅 '}， 


d=3，name=’ 围城 '"，author=' 钱 钟 书 '}，Book {id=4，name=' 宋 诗 选 注 ' ，author=' 钱 钟 书 '}] 
Book {id=3，name=' 围城 ，author=' 钱 钟 书 '} 


图 6-17 





6.3 Session 共享 


正常 情况 下 ，HttpSession 是 通过 Servlet 容器 创建 并 进行 管理 的 ， 创 建成 功 之 后 都 是 保存 在 内 
存 中 。 如 果 开 发 者 需要 对 项 目 进行 横向 扩展 搭建 集群 , 那么 可 以 利用 一 些 硬件 或 者 软件 工具 来 做 负 
载 均衡 ， 此 时 , 来 自 同一 用 户 的 HTTP 请 求 就 有 可 能 被 分 发 到 不 同 的 实例 上 去 ， 如 何 保证 各 个 实例 
之 间 Session 的 同步 就 成 为 一 个 必须 解决 的 问题 。Spring Boot 提供 了 自动 化 的 Session 共享 配置 ， 
它 结合 Redis 可 以 非常 方便 地 解决 这 个 问题 。 使 用 Redis 解决 Session 共享 问题 的 原理 非常 简单 ， 
就 是 把 原本 存储 在 不 同 服务 器 上 的 Session 拿 出 来 放 在 一 个 独立 的 服务 器 上 ， 如 图 6-18 所 示 。 


real server 1 


De 


real server 3 


图 6-18 
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当 一 个 请 求 到 达 Nginx 服务 器 后 ， 首 先进 行 请 求 分 发 ， 假 设 请 求 被 real serverl 处 理 了 ，real server 1 
在 处 理 请 求 时 ， 无 论 是 存储 Session 还 是 读 取 Session， 都 去 操作 Session 服务 器 而 不 是 操作 自身 内 
存 中 的 Session， 其 他 real server 在 处 理 请 求 时 也 是 如 此 ， 这 样 就 可 以 实现 Session 共享 了 。 


6.3.1 _ Session 共享 配置 


Spring Boot 中 的 Session 共享 配置 非常 容易 ,创建 Spring Boot Web 项 目 , 添 加 Redis 和 Session 
依赖 ， 代 码 如 下 : 














1 <dependency> 
2 <groupId>org.springframework.boot</groupId> 

3 <artifactId>spring-boot-starter-data-redis</artifactId> 
4 <exclusions> 

5 <exclusion> 

6 |<groupId>io.lettuce</groupId> 
7 <artifactId>lettuce-core</artifactId> 

8 | </exclusion> 

9 | </exclusions> 

0 | </dependency> 

1 | <dependency> 

2 | <groupId>redis.clients</groupId> 

3 | <artifactId>jedis</artifactId> 

4 | </dependency> 

5 | <dependency> 

6 | <groupId>org.springframework.boot</groupId> 

7 | <artifactId>spring-boot-starter-web</artifactId> 
8 | </dependency> 

9 | <dependency> 
20 | <groupId>org.springframework.session</groupId> 
21 | <artifactId>spring-session-data-redis</artifactId> 
22 | </dependency> 


除了 Redis 依赖 之 外 ， 这 里 还 要 提供 spring-session-data-redis 依赖 ，Spring Session 可 以 做 到 透 
明 化 地 蔡 换 掉 应 用 的 Session 容器 。 项 目 创建 成 功 后 ， 在 application properties 中 进行 Redis 基本 连 
接 信息 配置 ， 代 码 如 下 : 


spring.redis.database=0 
spring.redis.host=192.168.66.130 
spring.redis.port=6379 
spring.redis.password=123@456 
spring.redis.jedis.pool.max-active=8 
spring.redis.jedis.pool.max-idle=8 
spring.redis.jedis.pool.max-wait=-1lms 
spring.redis.jedis.pool.min-idle=0 


然后 创建 一 个 Controller 用 来 执行 测试 操作 ， 代 码 如 下 : 


@RestController 
发 public class HelloController { 





CE 
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3 Value ("${server.port}") 

4 String port; 

5 Q@PostMapping ("/save") 

6 public String saveName (String name, HttpSession session) { 
7 session.setAttribute ("name", name); 

8 return port; 

9 } 

10 Q@GetMapping ("/get") 

1 public String getName (HttpSession session) { 

12 return port + ":" + session.getAttribute ("name") .toString (); 
13 } 











这 里 提供 了 两 个 方法 ， 一 个 save 接口 用 来 向 Session 中 存储 数据 ， 还 有 一 个 get 接口 用 来 从 
Session 中 获取 数据 ， 这 里 注入 了 项 目 启动 的 端口 号 server.port, 主要 是 为 了 区 分 到 底 是 哪个 服务 器 
提供 的 服务 。 另 外 ， 虽 然 还 是 操作 的 HttpSession， 但 是 实际 上 HttpSession 容器 已 经 被 透明 蔡 换 ， 
真正 的 Session 此 时 存储 在 Redis 服务 器 上 。 

项 目 创建 完成 后 ， 将 项 目 打 成 jar 包 上 传 到 CentOS 上 。 然 后 执行 如 下 两 条 命令 启动 项 目 : 





hup java -jar session-0.0.1-SNAPSHOT.jar --server.port=8080 & 





nohup java -jar session-0.0.1-SNAPSHOT.jar --server.port=8081 & 


nohup 表示 不 挂 断 程序 运行 ， 即 当 终 端 窗口 关闭 后 ， 程 序 依然 在 后 台 运 行 ， 最 后 的 & 表 示 让 程 
序 在 后 台 运 行 。--server.port 表示 设置 启动 端口 ， 一 个 为 8080， 另 一 个 为 8081。 启 动 成 功 后 ， 接 下 
来 就 可 以 配置 负载 均衡 器 了 。 (关于 Linux 上 如 何 运 行 Spring Boot 工程 可 以 参考 本 书 第 15 章 。) 


6.3.2 Nginx 负载 均衡 


本 案例 使 用 Nginx 做 负载 均衡 。 首 先 在 CentOS 上 安装 Nginx， 安 装 过 程 如 下 。 
下 载 源码 并 解压 : 









wget https://nginx.org/download/nginx-1.14.0.tar.gz 
tar -zxvf nginx-1.14.0.tar.gz 


然后 进入 解压 目录 中 执行 编译 安装 ， 代 码 如 下 : 


cd nginx-1.14.0 
./configure 
make 








心 wb 上 


make install 





安装 成 功 后 ， 找 到 Nginx 安装 目录 ， 执 行 sbin 目录 下 的 nginx 文件 启动 nginx， 命 令 如 下 : 
Nginx 启动 成 功 后 ， 默 认 端 口 是 80， 可 以 在 物理 机 直接 访问 ， 如 图 6-19 所 示 。 
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Welcome to nginx! 


Tf you see this page, the nginx web server is successfully installed and 
working. Further configuration is required. 


For online documentation and support please refar to nginx org. 
Commercial support is available at nginx.com. 





Thark you for using ngirx. 





图 6-19 


接 下 来 进入 Nginx 安装 目录 修改 配置 文件 ， 代 码 如 下 : 








1 | vi /usr/local/nginx/conf/nginx.conf 
对 nginx.conf 文件 进行 编辑 ， 编 辑 内 容 如 下 : 

1 

i 

时 upstream sang.com{ 

4 server 192.168.66.130:8080 weight=1; 

5 server 192.168.66.130:8081 weight=1; 

6 } 

7 server { 

8 listen 80; 

9 server name localhost; 

10 location / { 

11 proxy_pass http://sang.com; 

12 proxy_redirect default; 

13 } 

14 

1 | 去 

16 | } 











这 里 只 列 出 了 修改 的 配置 ， 在 修改 的 配置 中 首先 配置 上 游 服务 器 ， 即 两 个 real server， 两 个 


real server 的 权重 都 是 1， 意 味 着 请 求 将 平均 分 配 到 两 个 real server 上 ， 然 后 在 server 中 配置 
拦截 规则 ， 将 拦截 到 的 请 求 转发 到 定义 好 的 real server 上 。 





配置 完成 后 ， 重 启 Nginx， 重 启 命令 如 下 : 


1 | /usr/local/nginx/sbin/nginx -s reload 
6.3.3 ”请 求 分 发 


当 real server 和 Nginx 都 启动 后 ， 调 用 “/save” 接 口 存储 数据 ， 如 图 6-20 所 示 。 
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posT * http://192.168.66.130:80/save?name= 江 南 一 点 十 


调用 的 端口 是 80, 即 调用 的 是 Nginx 服务 器 ,请 求 会 被 Nginx 转发 到 real server 上 进行 处 理 ， 
返回 值 为 8080， 说 明 真 正 处 理 请 求 的 real server 是 8080 那 台 服务 器 ， 接 下 来 调用 get 接口 
获取 数据 ， 如 图 6-21 所 示 。 





8651: 江 南 二 点 雨 | 


调用 端口 依然 是 80， 但 是 返回 值 是 8081， 说 明 是 8081 那 台 real server 提供 的 服务 ， 如 果 这 
里 不 是 8081， 再 访问 一 次 即 可 。 





经 过 如 上 步骤 ， 就 完成 了 利用 Redis 实现 Session 共享 的 功能 ， 基 本 上 不 需要 额外 配置 ， 开 箱 
即 用 。 


64 小 结 


本 章 主要 向 读者 介绍 了 Spring Boot 整合 NoSQL 数据 库 以 及 结合 Redis 实现 Session 共享 。 对 
于 NoSQL 数据 库 ， 介 绍 了 比较 常见 的 两 种 ， MongoDB 和 Redis。MongoDB 在 一 些 场景 中 甚至 可 
以 完全 蔡 代 关系 型 数据 库 ，Redis 更 多 的 使 用 场景 则 是 作为 缓存 服务 器 〈 本 书 第 9 章 将 详细 介绍 
Redis 缓存 ) ， 开 发 者 可 根据 具体 情况 选择 合适 的 NoSQL。 





构建 RESTful 服务 


本 章 概 要 
e REST 简介 


ee JPA 实现 REST 
e MongoDB 实现 REST 


7.1 REST 简介 


REST (Representational State Transfer) 是 一 种 Web 软件 架构 风格 ， 它 是 一 种 风格 ， 而 不 是 标 


准 ， 匹 配 或 兼容 这 种 架构 风格 的 网 络 服务 称 为 REST 服务 。REST 服务 简洁 并 且 有 





层次 ，REST 通 


常 基于 HITP、URI 和 XML 以 及 HTML 这 些 现 有 的 广泛 流行 的 协议 和 标准 。 在 REST 中 ， 资 源 是 





由 URI 来 指定 的 , 对 资源 的 增删 改 查 操 作 可 以 通过 HTTP 协议 提供 的 GET、POST、 














PUT、 DELETE 


等 方法 实现 。 使 用 REST 可 以 更 高 效 地 利用 缓存 来 提高 响应 速度 , 同时 REST 中 的 通信 会 话 状 态 由 
客户 端 来 维护 ， 这 可 以 让 不 同 的 服务 器 处 理 一 系列 请 求 中 的 不 同 请 求 ， 进 而 提高 服务 器 的 扩展 性 。 


在 前 后 端 分 离 项 目 中 ， 一 个 设计 良好 的 Web 软件 架构 必然 要 满足 REST 风格 。 





在 Spring MVC 框架 中 ， 开 发 者 可 以 通过 @RestController 注解 开发 一 个 RESTful 服务 ， 不 过 ， 
Spring Boot 对 此 提供 了 自动 化 配置 方案 ， 开 发 者 只 需要 添加 相关 依赖 就 能 快速 构建 一 个 RESTful 


服务 。 
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7.2 JPA 实 现 REST 


在 Spring Boot 中 ， 使 用 Spring Data JPA 和 Spring Data Rest 可 以 快速 开发 出 一 个 RESTful 应 
日 。 接 下 来 向 读者 介绍 Spring Boot 中 非常 方便 的 RESTful 应 用 开发 。 


| 





7.2.1 基本 实现 


1. 创建 项 目 
创建 Spring Boot 项 目 ， 添 加 如 下 依赖 : 
1 <dependency> 
2 <groupId>org.springframework.boot</groupId> 
3 <artifactId>spring-boot-starter-data-jpa</artifactId> 
4 | </dependency> 
5 <dependency> 
6 |<groupId>org.springframework.boot</groupId> 
了 <artifactId>spring-boot-starter-data-rest</artifactId> 
8 | </dependency> 
9 <dependency> 
10 | <groupId>com.alibaba</groupId> 
11 | <artifactId>druid</artifactId> 
12 | <version>1.1.9</version> 
13 | </dependency> 
14 | <dependency> 
15 | <groupId>mysql</groupId> 
16 | <artifactId>mysql-connector-java</artifactId> 
17 | <scope>runtime</scope> 
18 | </dependency> 





这 里 的 依赖 除了 数据 库 相 关 的 依赖 外 , 还 有 Spring Data JPA 的 依赖 以 及 Spring Data Rest 的 依 
赖 。 项 目 创建 完成 后 ， 在 application.properties 中 配置 基本 的 数据 库 连 接 信息 : 





1 | spring.datasource.type=com.alibaba.druid.pool .DruidDataSource 

或 spring.datasource.username=root 

a spring.datasource.password=123 

4 | spring.datasource.url=jdbc:mysql:///jparestful 

5 | spring.jpa.hibernate.ddl-auto=update 

6 | spring.jpa.database=mysql 

7 | spring.jpa.properties.hibernate.dialect=org.hibernate.dialect .MySQL57Dialect 
8 | spring.jpa.show-sql=true 





这 些 数据 库 配置 和 5.3 节 中 配置 JPA 的 信息 基本 一 致 ， 配 置 的 含义 就 不 再 袭 述 了 。 
2. 创建 实体 类 








pn 





| @Entity (name = "七 book" 
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public class Book { 
@Id 
Q@GeneratedValue (strategy = GenerationType.IDENTITY) 
private Integer id; 
private String name; 
private String author; 
// 省 略 getter/setter 


cmamwm 必 wm 


} 





3. 创建 BookRepository 


1 | public interface BookRepository extends JpaRepository<Book, Integer> { 
21} 








创建 BookRepository 类 继承 JpaRepository，JpaRepository 中 默认 提供 了 一 些 基本 的 操作 方法 ， 


代码 如 下 : 

l @NoRepositoryBean 

2 | public interface JpaRepository<T, ID> extends PagingAndSortingRepository<T, ID>, 
3 QueryByExampleExecutor<T> { 

4 List<T> findAll (); 

5 List<T> findAll (Sort sort); 

6 List<T> findAllById(Iterable<ID> ids); 

人 <S extends T> List<S> saveAll (Iterable<S> entities); 
8 void flush(); 

9 <S extends T> S saveAndFlush(S entity) 

10 void deleteInBatch (Iterable<T> entities); 

11 void deleteAllInBatch(); 

hd T getOne (ID id); 

13 @Override 

14 <S extends T> List<S> findAll (Example<S> example); 
15 @Override 


上 
a 


<S extends T> List<S> findAll (Example<S> example, Sort sort); 








一 


由 这 段 源码 可 以 看 到 ， 基 本 的 增删 改 查 、 分 页 查询 方法 JpaRepository 都 提供 了 。 
4. 测试 





经 过 如 上 几 步 ， 一 个 RESTful 服务 就 构建 成 功 了 ， 可 能 有 读者 会 问 “ 什 么 都 没 写 呀 ! ”， 是 


的 ， 这 就 是 Spring Boot 的 魅力 所 在 。 


RESTful 的 测试 首先 需要 有 一 个 测试 工具 ， 可 以 直接 使 用 浏览 器 中 的 插件 ， 例 如 Firefox 中 的 


RESTClient， 或 者 直接 使 用 Postman 等 工具 ， 笔 者 这 里 是 使 用 Postman 测试 的 。 
5. 添加 测试 
RESTful 服务 构建 成 功 后 ， 默 认 的 请 求 路 径 是 实体 类 名 小 写 再 加 上 后 级 。 


此 时 向 数据 库 添 加 一 条 数据 非常 容易 ， 发 起 一 个 post 请 求 ， 请 求 地 址 为 


http://localhost:8080/books， 如 图 7-1 所 示 。 
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POST http://localhos 





form-data 


二 raw binary ”JSON (application/json) 


{Pname":" 二 国 演义 ","author":" 罗 贯 中 "】 


Body 人) (9 


Pretty JSON 巴 








图 7-1 


当 添 加 成 功 后 ， 服 务 端 会 返回 刚刚 添加 成 功 的 数据 的 基本 信息 以 及 浏览 地 址 。 

6. 查询 测试 

查询 是 GET 请 求 ， 分 页 查询 请 求 路 径 为 books， 请 求 URL 如 下 : 
[rttp://localhost:8080/books ”| 


分 页 查询 请 求 默 认 每 页 记录 数 是 20 条 ， 页 数 为 0 (页码 从 0 开始 计 ) ， 查 询 结果 如 图 7-2 所 





如 果 按 照 id 查询 ， 只 需要 在 /books 后 面 追加 上 id 即 可 (如 图 7-3 所 示 ) ， 例 如 查询 id 为 1 的 
book， 请 求 URL 如 下 : 


1 | http://localhost:8080/books/1 
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GET http 


(1 加 








”embedded": { 
- "bocks": [ 
hy { 


"http://localhost:8888/books/1"” 


"http://localhost:8888/books/1" 








2 "http://localhost:8888/books/2" 
2 “http://localhost:8888/books/2" 
好 ] 
8 ~ ”_links": { 
1- "self": { 
2 "href": "http://localhost:8888/books{?page,size,sortj"， 
"templated": true 
34 }, 
Se "profile": { 
"href": "http://localhost:8888/profile/books" 
} 
} 
. "page”: { 


"size”: 29， 
alElenents": 2, 
totalpages": 1, 
”number": @ 














图 7-2 
在 图 7-2 查询 所 有 数据 返回 的 结果 中 , 除了 所 有 图 书 的 基本 信息 外 , 还 有 如 何 发 起 一 个 分 页 请 
求 以 及 当前 页 面 的 分 页 信息 。 如 果 开 发 者 想 要 修改 请 求 页 码 和 每 页 记录 数 ,只 需要 在 请 求 地 址 中 携 
带 上 相关 参数 即 可 ， 如 下 请 求 表示 查询 第 2 页 数据 并 且 每 页 记录 数 为 3: 
1 | http://localhost:8080/books?page=1&size=3 


除了 分 页 外 ， 默 认 还 支持 排序 ， 例 如 想 查询 第 2 页 数据 ， 每 页 记录 数 为 3， 并 且 按 照 id 倒序 
排列 ， 请 求 地 址 如 下 : 


























1 | http://localhost:8080/books?page=1&size=3&sort=id, desc 
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htrp://localhost:8080/books/1 


GET 








图 7-3 


7. 修改 测试 
发 送 PUT 请 求 可 实现 对 数据 的 修改 , 对 数据 的 修改 是 通过 id 进行 的 , 因此 请 求 路 径 中 要 有 id， 
例如 如 下 请 求 路 径 表示 修改 id 为 2 的 记录 ， 有 具体 的 修改 内 容 在 请 求 体 中 ， 如 图 7-4 所 示 。 


http://localhost:8080/books/2 





PUT http://localhost:8080/books/2 


form-data x-www-form-urlencoded 。 者 raw binary 。 JSON (applicationjson) 


工 {"name":" 红 楼 梦 2","author":" 坎 委 芹 2 小 








Body (TD (9 
Pretty 

5- : 
6 "href": “http://localhost:8988/books/2” 
7 }, 

~ ”book": { 

"href": “http://localhost:8888/books/2” 

1 
11 } 
2 } 





图 7-4 
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PUT 请 求 的 返回 结果 就 是 被 修改 之 后 的 记录 。 
8. 删除 测试 
发 送 DELETE 请 求 可 以 实现 对 数据 的 删除 操作 ， 例 如 删除 id 为 1 的 记录 ， 请 求 URL 如 下 : 


DELETE 请 求 没有 返回 值 ， 上 面 这 个 请 求 发 送 成 功 后 ，id 为 1 的 记录 就 被 删除 了 。 

















7.2.2 自 定义 请 求 路 径 


默认 情况 下 ， 请 求 路 径 都 是 实体 类 名 小 写 加 s， 如 果 开 发 者 想 对 请 求 路 径 进 行 重 定义 ， 通 过 
@RepositoryRestResource 注解 即 可 实现 ， 下 面 的 案例 只 需 在 BookRepository 上 添加 
@RepositoryRestResource 注解 即 可 : 


QRepositoryRestResource (path = "bs",collectionResourceRel = "bs",itemResourceRel = 
wp") 


public interface BookRepository extends JpaRepository<Book, Integer> { 
} 





@RepositoryRestResource 注解 的 path 属性 表示 将 所 有 请 求 路 径 中 的 books 都 修改 为 bs， 如 
http://localhost:8080/bs; collectionResourceRel 属性 表示 将 返回 的 JSON 集合 中 book 集合 的 key 修 
改 为 bs; itemResourceRel 表示 将 返回 的 JSON 集合 中 的 单个 book 的 key 修改 为 b， 如 图 7-5 所 示 。 











”embedded": { collectionResourceRel 
"bs 
{ 
": "红楼 梦 2"， 
} 
了 





7.2.3 自 定义 查询 方法 


默认 的 查询 方法 支持 分 页 查询 、 排 序 查询 以 及 按照 id 查询 ， 如 果 开 发 者 想 要 按照 某 个 属性 查 
询 ， 只 需 在 BookRepository 中 定义 相关 方法 并 暴露 出 去 即 可 ， 代 码 如 下 : 








Q@RepositoryRestResource (path = "bs",collectionResourceRel = "bs",itemResourceRel = 
2 | "bm) 
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public interface BookRepository extends JpaRepository<Book, Integer> { 


} 


@RestResource (path = "author", rel = "author") 

List<Book> findByAuthorContains (@Param("author") String author); 
QRestResource (path = "name",rel = "name") 

Book findByNameEquals (@Param("name") String name); 








7.2.4 





代码 解释 : 


自 定义 查 询 只 需要 在 BookRepository 中 定义 相关 查询 方法 即 可 ， 方 法 定义 好 之 后 可 以 不 添加 
@RestResource 注解 ， 默 认 路 径 就 是 方法 名 。 以 第 4 行 定义 的 方法 为 例 ， 若 不 添加 
@RestResource 注解 ， 则 默认 该 方法 的 调用 路 径 为 
http:Wlocalhost:8080/bs/searchy/findByAuthorContains?author= 重 迅 。 如 果 想 对 查询 路 径 进行 自 定 
义 ， 只 需要 添加 @RestResource 注解 即 可 ，path 属性 即 表示 最 新 的 路 径 。 还 是 以 第 4 行 的 方 
法 为 例 ， 添 加 (@RestResource(path = "author'rel = "author") 注解 后 的 查询 路 径 为 
“http://localhost:8080/bs/search/author?author= 和 鲁迅 ” 

用 户 可 以 直接 访问 http://localhost:8080/bs/search 路 径 查 看 该 实体 类 暴露 出 来 了 哪些 查询 方法 ， 
默认 情况 下 ， 在 查询 方法 展示 时 使 用 的 路 径 是 方法 名 ， 通 过 @RestResource 注解 中 的 rel 属性 
可 以 对 这 里 的 路 径 进行 重 定义 ， 如 图 7-6 所 示 。 


GET http://localhost:8080/bs/search 


@RestResource 注 解 中 的 rel 属 性 


Body (1 (3) 


4 "href": "http://localhost:8980/bs/search/name{ ?name}", 
"templated": true 


“href": “http://localhost:8080/bs/search/author{?author}", 
9 "templated": true 


I "self"”: { 
12 ”href": “http://localhost:8988/bs/search” 
13 } 


14 } 








隐藏 方法 


默认 情况 下 ， 凡 是 继承 了 Repository 接口 (或 者 Repository 的 子 类 ) 的 类 都 会 被 暴露 出 来 ， 即 


开发 者 可 执行 基本 的 增删 改 查 方法 。 以 上 文 的 BookRepository 为 例 ， 如 果 开 发 者 提供 了 


BookRepository 继承 自 Repository， 就 能 执行 对 Book 的 基本 操作 ， 如 果 开 发 者 继承 了 Repository 
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但 是 又 不 想 暴露 相关 操作 ， 做 如 下 配置 即 可 : 


1 Q@RepositoryRestResource (exported = false,) 





2 | public interface BookRepository extends JpaRepository<Book, Integer> { 
| 
将 @RepositoryRestResource 注解 中 的 exported 属性 置 为 false 之 后 ， 则 7.2.4 小 节 中 展示 的 增 
删改 查 接口 都 会 失效 ，BookRepository 类 中 定义 的 相关 方法 也 会 失效 。 若 只 是 单纯 地 不 想 暴露 某 个 
方法 ， 则 在 方法 上 进行 配置 即 可 ， 例 如 开发 者 想 屏蔽 DELETE 接口 ， 做 如 下 配置 即 可 : 





Q@RepositoryRestResource (path = "bs",collectionResourceRel = "bs",itemResourceRel = 
2 | "br") 

3 | public interface BookRepository extends JpaRepository<Book, Integer> { 

4 Override 

9 @RestResource (exported = false) 

6 void deleteById(Integer integer) ; 





@RestResource 注解 的 exported 属性 默认 为 tue， 将 之 置 为 false 即 可 。 


7.2.5 配置 CORS 


在 4.6 节 已 经 向 读者 介绍 了 CORS 两 种 不 同 的 配置 方式 ， 一 种 是 直接 在 方法 上 添加 
@CrossOrigin 注解 ， 另 一 种 是 全 局 配置 。 全 局 配置 在 这 里 依然 适用 ， 但 是 默认 的 RESTful 工程 不 
需要 开发 者 自己 提供 Controller， 因 此 添加 在 Controller 的 方法 上 的 注解 可 以 直接 写 在 
BookRepository 上 ， 代 码 如 下 : 


@CrossOrigin 

Q@RepositoryRestResource (path = "bs") 

public interface BookRepository extends JpaRepository<Book, Integer> { 
QRestResource (path = "author", rel = "author") 
List<Book> findByAuthorContains (@Param("author") String author); 
@RestResource (path = "name",rel = "name") 
Book findByNameEquals (@Param("name") String name); 


cam 必 wm 





此 时 ，BookRepository 中 的 所 有 方法 都 支持 跨 域 。 如 果 只 需要 某 一 个 方法 支持 跨 域 ， 那 么 将 
@CrossOrigin 注解 添加 到 某 一 个 方法 上 即 可 。 关 于 @CrossOrigin 注解 的 详细 用 法 可 以 参考 4.6 节 。 


7.2.6 ”其 他 配置 


开发 者 也 可 以 在 application.properties 中 配置 一 些 常 用 属性 ， 代 码 如 下 : 
# 每 页 默认 记录 数 ， 默 认 值 为 20 


spring.data.rest.default-page-size=2 


# 分 页 查询 页 码 参数 名 ， 默 认 值 为 page 


spring.data.rest .page-param-name=page 


# 分 页 查询 记录 数 参数 名 ， 默 认 值 为 size 
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spring.data.rest.limit-param-name=size 

# 分 页 查询 排序 参数 名 ， 默 认 值 为 sort 
spring.data.rest.sort-param-name=SsoLt 
#base-path 表示 给 所 有 请 求 路 径 都 加 上 前 级 

10 | spring.data.rest.base-path=/api 

11 | # 添 加 成 功 时 是 否 返 回 添加 内 容 

12 | spring.data.rest.return-body-on-create=true 
13 | # 更 新 成 功 时 是 否 返 回 更 新 内 容 


14 | spring.data.rest.return-body-on-update=true 


当然 ， 这 些 XML 配置 也 可 以 在 Java 代码 中 配置 ， 且 代码 中 配置 的 优先 级 高 于 
application.properties 配置 的 优先 级 ， 代 码 如 下 : 


@Configuration 
public class RestConfig extends RepositoryRestConfigurerAdapter { 
QOverride 
public void configureRepositoryRestConfiguration (RepositoryRestConfiguration 
config) { 
config.setDefaultPageSize (2 
.SetPageParamName ("page") 
.setLimitParamName ("size") 
.SetSortParamName ("sort") 
.SetBasePath ("/api") 
.SetReturnBodyOnCreate (true) 
.SetReturnBodyOnUpdate (true); 




















这 里 每 项 代码 配置 的 含义 都 和 application.properties 中 的 配置 一 一 对 应 ， 因 此 不 再 袭 述 。 
LT 
7.3 MongoDB 实现 REST 


在 6.2 节 中 向 读者 介绍 了 MongoDB 整合 Spring Boot， 而 使 用 Spring Boot 快速 构建 RESTful 
服务 除了 结合 Spring Data JPA 之 外 ， 也 可 以 结合 Spring Data MongoDB 实现 。 使 用 Spring Data 
MongoDB 构建 RESTful 服务 也 是 三 个 步骤 ， 分 别 如 下 。 


1. 创建 项 目 
首先 创建 Spring Boot Web 项 目 ， 添 加 如 下 依赖 : 


<dependency> 

<groupId>org. springframework.boot</groupId> 
<artifactId>spring-boot-starter-data-mongodb</artifactId> 
</dependency> 

<dependency> 

<groupId>org. springframework.boot</groupId> 
<artifactId>spring-boot-starter-data-rest</artifactId> 
</dependency> 


1 
2 
3 
4 
5 
6 
7 
8 
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这 里 Spring Data Rest 的 依赖 和 7.2 节 中 的 一 致 ,只 是 将 Spring Data JPA 的 依赖 变 为 Spring Data 
MongoDB 的 依赖 。 项 目 创建 成 功 后 ， 在 application.properties 中 配置 MongoDB 的 基本 连接 信息 ， 
代码 如 下 : 


spring.data.mongodb.authentication-database=test 
spring.data.mongodb.database=test 





spring.data.mongodb.username=sang 
spring.data.mongodb.password=123 
spring.data.mongodb.host=192.168.248.144 
spring.data.mongodb.port=27017 


这 段 配置 的 含义 可 以 参考 6.2.3 节 ， 这 里 不 再 歼 述 。 
2. 创建 实体 类 
接 下 来 创建 一 个 普通 的 Book 实体 类 ， 代 码 如 下 : 


public class Book { 
private Integer id; 
private String name; 
private String author; 
// 省 上 getter/setter 





aAMArnoDPe 











3. 创建 BookRepository 
创建 BookRepository 实现 对 Book 的 基本 操作 : 
1 | public interface BookRepository extends MongoRepository<Book, Integer> { 
2 1} 
如 此 之 后 ， 一 个 RESTful 服务 就 搭建 成 功 了 。 在 启动 Spring Boot 项 目 之 前 ， 记 得 要 先 启动 
MongoDB。Spring Boot 项 目 启动 成 功 后 ， 接 下 来 的 测试 环节 与 7.2.1 小 节 的 第 5~8 步 一 致 。 另 外 ， 
7.2.2~7.2.6 小 节 介 绍 的 Spring Data Rest 配置 在 这 里 一 样 适用 ， 因 此 不 再 熬 述 。 








7.4 小 结 


本 章 向 读者 介绍 了 Spring Boot 构建 RESTful 服务 ， 结 合 Spring Data Rest、Spring Data JPA 以 
及 Spring Data MongoDB，Spring Boot 可 以 快速 构建 出 一 个 基本 的 RESTful 服务 ， 而 开发 者 可 以 结 
合 具体 情况 选择 关系 型 数据 库 或 者 非 关 系 型 数据 库 作为 数据 支撑 。 在 一 些 常 规 功能 的 项 目 中 ， 
Spring Boot 的 这 些 特 性 可 以 帮助 开发 者 省 去 许多 繁杂 腾 肿 的 配置 。 


开发 者 工具 与 单元 测试 


本 章 概 要 
@ devtools 简介 


@ devtools 实战 
e 单元 测试 


8.1 devtools 简介 





Spring Boot 中 提供 了 一 组 开发 工具 spring-boot-devtools， 可 以 提高 开发 者 的 工作 效率 ,开发 者 
可 以 将 该 模块 包含 在 任何 项 目 中 ，spring-boot-devtools 最 方便 的 地 方 莫 过 于 热 部 署 了 。 


8.2 devtools 实战 


8.2.1 基本 用 法 


要 想 在 项 目 中 加 入 devtools 模块 ， 只 需 添加 相关 依赖 即 可 ， 代 码 如 下 : 


有 <dependency> 
2 | <groupId>org.springframework.boot</groupId> 
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3 | <artifactId>spring-boot-devtools</artifactId> 
4 | <optional>true</optional> 





5 | </dependency> 





这 里 多 了 一 个 optional 选项 ， 是 为 了 防止 将 devtools 依赖 传递 到 其 他 模块 中 。 当 开发 者 将 应 
用 打包 运行 后 ，devtools 会 被 自动 禁用 。 





当 开 发 者 将 spring-boot-devtools 引入 项 目 后 ， 只 要 classpath 路 径 下 的 文件 发 生 了 变化 ， 项 目 
就 会 自动 重启 ， 这 极 大 地 提高 了 项 目的 开发 速度 。 如 果 开 发 者 使 用 了 Eclipse， 那 么 在 修改 完 代 码 
并 保存 之 后 ， 项 目 将 自动 编译 并 触发 重启 ， 而 开发 如 果 使 用 了 IntelliJ IDEA， 默 认 情况 下 ， 需 要 开 
发 者 手动 编译 才 会 触发 重启 。 手 动 编译 时 ， 单 击 Build 一 Build Project 菜单 或 者 按 Ctrl+F9 快捷 键 进 
行 编译 , 编译 成 功 后 就 会 触发 项 目 重启 。 当 然 , 使 用 IntelliJ IDEA 的 开发 者 也 可 以 配置 项 目 自动 编 
译 ， 配 置 步 又 如 下 : 

步骤 014 单 击 File 一 Settings 菜单 ， 打 开 Settings 页 面 ， 在 左边 的 菜单 栏 依次 找到 
Build,Execution,Deployment 一 Compile， 勾 选 Build project automatically， 如 图 8-1 所 示 。 





国 Setings x 
人 ) Build Execution Deployment » Compiler © For current project Reset 
Version Control ® Resource patterns: [17°java;l?",.form:!?".class;l?",groowy:!?".scala;l?".flex!?".kt!17".cll?".a) 画 





+ Build, Execution Deployment Use’; to separate patters and ! to negate 3 pattern. Accepted wildcards: ?— exactly one symbol; 
*— zero or more symbols; / — path separator /"/ 一 any number of directories <dir name>: 


Build Tools 看 <pattem> — restrict to source roots with the specified name 
Clear output directory on rebuild 


Exdudes Add runtime assertions for not-null-annotated methods and parameters | Configure annotations... 


Java Compiler 
加 ee 
a » 回 Automaticaly show first errorin editor 


Validation Display notification on build completion 


RMI Compiler 1 Build project automaticaly (only works while not running / debugging) 


Groow Compiler @ 口 Compile independent modules in paralle! (may require larger heap size) 
Mionioipt & Fer Compior Rebuild module on dependency change 
Android Compilers 
Build process heap size (Mbytes): 700 
Kotin Compiler 
Shared build process VM options: 


Debugger 
Deployment User-local build process VM options (overrides Shared options): 
Arquillian Containers @ WARNING! 

A if option ‘Clear output directory on rebuild' is enabled the entire contents of directories where 
Pe ey generated sources are stored WILL BE CLEARED on rebuild. 





EE [ene Lo | | vee | 





图 8-1 











步 又 024 按 Ctrl+Shift+Alt+/ 快 捷 键 调 出 Maintenance 页 面 ， 如 图 8-2 所 示 。 


. Registry... 








. UI Debugger 


1 

2. Switch Boot JDK 

3 

4. Dump lookup element weights to log ”Ctrl+Akt+Shift+W 





图 8-2 
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单 击 Registry， 在 新 打开 的 Registry 页 面 中 ， 勾 选 compiler.automake.allow.when.app.running 复 
选 枉 ， 如 图 8-3 所 示 。 


Registry 











外 Changing these values may cause unwanted behavior of IntelliJ 1Di 
台 雪 :| 





革 onpiierautomakeauowwhenapprunning 





actionSystem.assertFocusAccessFromEdt 
actionSystem.commandprocessingTimeout 30000 
图 8-3 


做 完 这 两 步 配置 之 后 ， 若 开发 者 再 次 在 IntelliJ IDEA 中 修改 代码 ， 则 项 目 会 自动 重启 。 





classpath 路 径 下 的 静态 资源 或 者 视图 模板 等 发 生变 化 时 ， 并 不 会 导致 项 目 重启 。 


8.2.2 ”基本 原理 


Spring Boot 中 使 用 的 自动 重启 技术 涉及 两 个 类 加 载 器 ， 一 个 是 baseclassloader， 用 来 加 载 不 会 
变化 的 类 ， 例 如 项 目 引用 的 第 三 方 的 jar;， 另 一 个 是 restartclassloader， 用 来 加 载 开 发 者 自己 写 的 会 
变化 的 类 。 当 项 目 需要 重启 时 , restartclassloader 将 被 一 个 新 创建 的 类 加 载 器 代替 , 而 baseclassloader 
则 继续 使 用 原来 的 ， 这 种 启动 方式 要 比 冷 启 动 快 很 多 ， 因 为 baseclassloader 已 经 存在 并 且 已 经 加 载 
好 。 


8.2.3 自 定义 监控 资源 


默认 情况 下 , /META-INF/maven、/META-INF/resources、/resources、/static、/public 以 及 /templates 
位 置 下 资源 的 变化 并 不 会 触发 重启 ， 如 果 开 发 者 想 要 对 这 些 位 置 进 行 重 定义 ,在 
application.properties 中 添加 如 下 配置 即 可 : 
GTspring.devtools.restart.exclude-static/:** | 
这 表示 从 默认 的 不 触发 重启 的 目录 中 除去 static 目录 ， 即 classpath:static 目录 下 的 资源 发 生变 
化 时 也 会 导致 项 目 重启 。 用 户 也 可 以 反 向 配置 需要 监控 的 目录 ， 配 置 方式 如 下 : 
1 | spring.devtools. restart.additional-paths-=src/main/resources/static 


这 个 配置 表示 当 src/main/resources/static 目录 下 的 文件 发 生变 化 时 ， 自 动 重启 项 目 。 

由 于 项 目的 编码 过 程 是 一 个 连续 的 过 程 ， 并 不 是 每 修改 一 行 代码 就 要 重启 项 目 ， 这 样 不 仅 浪 
费 电脑 性 能 ,， 而且 没有 实际 意义 。 鉴 于 这 种 情况 ,开发 者 也 可 以 考虑 使 用 触发 文件 ， 触 发 文件 是 一 
个 特殊 的 文件 ， 当 这 个 文件 发 生变 化 时 项 目 就 会 重启 ， 配 置 方 式 如 下 : 
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1 | spring.devtools.restart.trigger-file=.trigger-file 
在 项 目 resources 目录 下 创建 一 个 名 为 .trigger-file 的 文件 ， 此 时 当 开 发 者 修改 代码 时 ， 默 认 情 
况 下 项 目 不 会 重启 ， 需 要 项 目 重 启 时 ,开发 者 只 需要 修改 .trigger-file 文件 即 可 。 但 是 注意 ， 如 果 项 
目 没有 改变 ， 只 是 单纯 地 改变 了 .trigger-file 文件 ， 那 么 项 目 不 会 重启 。 











8.2.4 使 用 LiveReload 


上 一 小 节 介 绍 了 静态 资源 目录 下 的 文件 变化 以 及 模板 文件 的 变化 不 会 引发 重启 ， 虽 然 开发 者 
可 以 通过 修改 配置 改变 这 一 默认 情况 ,但 实际 上 并 没有 必要 ， 因 为 静态 文件 不 是 class。devtools 默 





















































认 幅 入 了 LiveReload 服务 器 ， 可 以 解决 静态 文件 的 热 部 署 ，LiveReload 可 以 在 资源 发 生变 化 时 自 
动 触发 浏览 器 更 新 ，LiveReload 支持 Chrome、Firefox 以 及 Safari。 以 Chrome 为 例 ， 在 Chrome 应 
用 商店 搜索 LiveReload， 结 果 如 图 8-4 所 示 。 
6 LiveReload 二 添加 至 CHROME 
加 @ | rm 
se a 23 
| mimosa-lvereload 
La a cr 
GooseF 吕 S 和 
全 可 
Aneroda 
页 接 Googje 云 湖绿 盘 
© 开 才 者 I 具 
: 离 雇 交 太 友 
图 8-4 
将 第 一 个 搜索 结果 添加 到 Chrome 中 , 添加 成 功 后 , 在 Chrome 右上 角 有 一 个 LiveReload 图 标 ， 
如 图 8-5 所 示 。 








图 8-5 


在 浏览 器 中 打开 项 目的 页 面 ， 然 后 单 击 浏览 器 右上 角 的 LiveReload 按钮 ， 开 启 LiveReload 连 
接 ， 此 时 当 静 态 资源 发 生 改变 时 ,浏览 器 就 会 自动 加 载 。 如 果 开 发 者 不 想 使 用 这 一 特性 ， 可 通过 如 
下 配置 关闭 : 


| spring.devtools.livereload.enabled=false 

















建议 开发 者 使 用 LiveReload 策略 而 不 是 项 目 重启 策略 来 实现 静态 资源 的 动态 加 载 ， 因 为 项 
目 重启 所 耗费 的 时 间 一 般 要 超过 LiveReload.。 
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在 Firefox 中 安装 LiveReload， 首 先 打开 附加 组 件 页 面 ， 如 图 8-6 所 示 。 然 后 在 附加 组 件 中 
搜索 LiveReload 并 安装 ， 用 法 和 Chrome 一 致 ， 这 里 不 再 夷 述 。 
yy 疏 回 电 电 


他 上 





GB en 


8.2.5 ”禁用 自动 重启 


如 果 开 发 者 添加 了 spring-boot-devtools 依赖 但 是 不 想 使 用 自动 重启 特性 , 那么 可 以 关闭 自动 重 





启 ， 代 码 如 下 : 





1 | spring.devtools.restart.enabled=false 


也 可 以 在 Java 代码 中 配置 禁止 自动 重启 ， 配 置 方 式 如 下 : 











AmoODPp 





@Spring BootApplication 
public class DevtoolsApplication { 
public static void main(String[] args) { 
System. setProperty ("spring.devtools.restart.enabled", "false"); 
SpringApplication.run(DevtoolsApplication.class, args); 


} 





8.2.6 ”全 局 配置 


如 果 项 目 模块 众多 ， 开 发 者 可 以 在 当前 用 户 目录 下 创建 spring-bootdevtools.properties 文件 来 
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对 devtools 进行 全 局 配置 ， 这 个 配置 文件 适用 于 当前 计算 机 上 任何 使 用 了 devtools 模块 的 Spring 
Boot 项 目 。 以 笔者 的 电脑 为 例 ， 在 C:\Users\sang 目录 下 创建 .spring-boot-devtools.properties 文件 ， 
内 容 如 下 : 


1 | spring.devtools.restart.trigger-file=.trigger-file 


此 时 ， 就 实现 了 使 用 触发 文件 触发 项 目 重启 。 




















8.3 单元 测试 


在 本 书 前 面 的 章节 中 , 遇 到 需要 测试 的 地 方 都 是 创建 一 个 Controller 进行 测试 , 这 样 操作 腑 肿 ， 
效率 低下 ， 在 Spring Boot 中 使 用 单元 测试 可 以 实现 对 每 一 个 环节 的 代码 进行 测试 。Spring Boot 中 
的 单元 测试 与 Spring 中 的 测试 一 脉 相 承 ， 但 是 又 做 了 大 量 的 简化 ， 只 需要 少量 的 代码 就 能 搭建 一 
个 测试 环境 , 进而 实现 对 Controller、Service 或 者 Dao 层 的 代码 进行 测试 。 接 下 来 向 读者 介绍 Spring 
Boot 中 单元 测试 的 主要 用 法 。 


8.3.1 基本 用 法 


当 开 发 者 使 用 IntelliJ IDEA 或 者 在 线 创建 一 个 Spring Boot 项 目 时 ， 创 建成 功 后 ， 默 认 都 添加 
了 spring-boot-starter-test 依赖 ， 并 且 创建 好 了 测试 类 ， 代 码 如 下 : 
QRunWith (SpringRunner.class) 


QSpring BootTest 
public class Test01ApplicationTests { 


@Test 
public void contextLoads() { 
’ 





代码 解释 : 
@ 这 里 首先 使 用 了 @RunWith 注解 ,该 注解 将 JUnit 执 行 类 修改 为 SpringRunner, 而 SpringRunner 
是 Spring Framework 中 测试 类 SpringJUnit4ClassRunner 的 别名 。 
ee (@Spring BootTest 注解 除了 提供 Spring TestContext 中 的 常规 测试 功能 之 外 ， 还 提供 了 其 他 特 
性 : 提供 默认 的 ContextLoader、 自 动 搜索 @Spring BootConfiguration、 自 定义 环境 属性 、 为 
不 同 的 webEnvironment 模式 提供 支持 ， 这 里 的 webEnvironment 模式 主要 有 4 种 : 
> MOCK， 这 种 模式 是 当 classpath 下 存在 servletAPIS 时 ， 就 会 创建 WebApplicationContext 
并 提供 一 个 mockservlet 环境 ; 当 classpath 下 存在 Spring WebFlux 时 ， 则 创建 
ReactiveWebApplicationContext; 若 都 不 存在 ， 则 创建 一 个 常规 的 ApplicationContext。 
> RANDOM PORT,， 这 种 模式 将 提供 一 个 真实 的 Servlet 环境 ， 使 用 内 识 的 容器 ， 但 是 端口 
随机 。 
> DEFINED PORT， 这 种 模式 也 将 提供 一 个 真实 的 Servlet 环境 ， 使 用 内 识 的 容器 ， 但 是 使 
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用 定义 好 的 端口 。 
> NONE， 这 种 模式 则 加 载 一 个 普通 的 ApplicationContext， 不 提供 任何 Servlet 环境 。 这 种 
一 般 不 适用 于 Web 测试 。 


e 在 Spring 测试 中 ， 开 发 者 一 般 使 用 @ContextConfiguration(classes = ) 或 者 
@ContextConfiguration(locations = ) 来 指定 要 加 载 的 Spring 配置, 而 在 Spring Boot 中 则 不 需要 
这 么 麻烦 ，Spring Boot 中 的 @*Test 注解 将 会 去 包含 测试 类 的 包 下 查找 带 有 @Spring 
BootApplication 或 者 @Spring BootConfiguration 注解 的 主 配置 类 。 

ee QTest 注解 则 来 则 junit，junit 中 的 @After、@AfterClass、(@Before、(@BeforeClass、@Ienore 
等 注解 一 样 可 以 在 这 里 使 用 。 


8.3.2 Service 测试 


Service 层 的 测试 就 是 常规 测试 ， 非 常 容易 ， 例 如 现在 有 一 个 HelloService 如 下 : 


QService 
public class HelloService { 
public String sayHello(String name) { 
return "Hello " + name + " !"; 


} 


ao mw 





需要 对 HelloService 进行 测试 ， 直 接 在 测试 类 中 注入 HelloService 即 可 : 


@RunWith (SpringRunner.class) 
@Spring BootTest 
public class Test01ApplicationTests { 
@Autowired 
HelloService helloService; 
QTest 
public void contextLoads () { 
String hello = helloService.sayHello("Michael"); 
Assert.assertThat (hel1lo,Matchers.is("Hello Michael !")); 








FeDoeDmnammmwm 


在 测试 类 中 注入 HelloService， 然 后 调用 相关 方法 即 可 。 第 9 行使 用 Assert 判断 测试 结果 是 否 
正确 。 





8.3.3 ”Controller 测试 


Controller 测试 则 要 使 用 到 Mock 测试 ， 即 对 一 些 不 易 获取 的 对 象 采 用 虚拟 的 对 象 来 创建 进而 
方便 测试 。 而 Spring 中 提供 的 MockMvc 则 提供 了 对 HTTP 请 求 的 模拟 , 使 开发 者 能 够 在 不 依赖 网 
络 环境 的 情况 下 实现 对 Controller 的 快速 测试 。 例 如 有 如 下 Controller: 


Ei Q@RestController 
发 public class HelloController { 
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@GetMapping ("/hello") 
public String hello(String name) { 
return "Hello " + name + " !"; 


Q@PostMapping ("/book") 
public String addBook (@RequestBody Book book) { 


3 
4 
思 
6 } 
7 
8 
9 return book.toString(); 





Controller 中 涉及 的 实体 类 Book 如 下 : 


public class Book { 
private Integer id; 
private String name; 
private String author; 


// 省 略 getter/setter 方法 





1 
恤 
3 
4 
5 
6 





如 果 要 对 这 个 Controller 进行 测试 ， 就 需要 借助 MockMvc， 代 码 如 下 : 





由 @RunWith (SpringRunner.class) 

2 Q@Spring BootTest 

3 | public class Test0lApplicationTests { 

4 @Autowired 

5 HelloService helloService; 

6 @Autowired 

7 WebApplicationContext wac; 

8 MockMvc mockMvc; 

9 QBefore 

10 public void before() { 

11 mockMvc = MockMvcBuilders .webAppContextSetup (wac) .build(); 
12 } 

13 QTest 

14 public void test1l() throws Exception { 

5 MvcResult mvcResult = mockMvc.perform( 

16 MockMvcRequestBuilders 

和 .get ("/hello") 

18 .contentType (MediaType .APPLICATION FORM URLENCODED) 
19 .param("name", "Michael")) 

20 .andExpect (MockMvcResultMatchers.status () .isOk()) 
21 .andDo (MockMvcResultHandlers .print ()) 

22 .andReturn(); 

23 System.out .println (mvcResult.getResponse () .getContentAsString ()); 
24 } 

25 QTest 

26 public void test2 () throws Exception { 

27 ObjectMapper om = new ObjectMapper (); 

28 Book book = new Book(); 

29 book.setAuthor ("罗贯中 ") ; 











30 book.setName (" 二 | 
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book.setId(1); 
String s = om.writeValueAsString (book); 
MvcResult mvcResult = mockMvc 


.perform (MockMvcRequestBuilders 
.post ("/book") 
.contentType (MediaType.APPLICATION JSON) 
.Content (s)) 
.andExpect (MockMvcResultMatchers.status () .isOk()) 
.andReturn(); 
System.out .println (mvcResult.getResponse () .getContentAsString ()); 





代码 解释 : 


@ 第 6、7 行 注入 一 个 WebApplicationContext 用 来 模拟 ServletContext 环境 。 
。 第 8 行 声明 一 个 MockMvc 对 象 ， 并 在 每 个 测试 方法 执行 前 进行 MockMve 的 初始 化 操作 (第 


9~12 行 )。 


@ 第 15 行 调用 MockMve 中 的 perform 方法 开启 一 个 RequestBuilder 请 求 ， 具 体 的 请 求 则 通过 


MockMvcRequestBuilders 进行 构建 ， 调 用 MockMvcRequestBuilders 中 的 get 方法 表示 发 起 一 
个 GET 请 求 , 调用 post 方法 则 发 起 一 个 POST 请求， 其 他 的 DELETE 和 了 PUT 请 求 也 是 一 样 
的 ， 最 后 通过 调用 param 方法 设置 请 求 参 数 。 

第 20 行 表 示 添 加 返回 值 的 验证 规则 ， 利 用 MockMvcResultMatchers 进行 验证 , 这 里 表示 验证 
响应 码 是 否 为 200。 

第 21 行 表示 将 请 求 详细 信息 打印 到 控制 台 。 

第 22 行 表示 返回 相应 的 MvcResult， 并 在 23 行将 之 获取 并 打印 出 来 。 

test2 方法 演示 了 POST 请 求 如 何 传递 JSON 数据 ， 首 先 在 32 行将 一 个 book 对 象 转 为 一 段 
JSON, 然后 在 36 行 设置 请 求 的 contentType 为 APPLICATION-JSON, 最 后 在 37 行 设置 content 
为 上 传 的 JSON 即 可 。 


除了 MockMve 这 种 测试 方式 之 外 ，Spring Boot 还 专门 提供 了 TestRestTemplate 用 来 实现 集成 


测试 ， 若 开发 者 使 用 了 @Spring BootTest 注解 ， 则 TestRestTemplate 将 自动 可 用 ， 直 接 在 测试 类 中 
注入 即 可 。 注 意 ， 如 果 要 使 用 TestRestTemplate 进行 测试 ， 需 要 将 @Spring BootTest 注解 中 
webEnvironment 属性 的 默认 值 由 WebEnvironment MOCK 修改 为 WebEnvironmentDEFINED PORT 
或 者 WebEnvironmentRANDOM _ PORT， 因为 这 两 种 都 是 使 用 一 个 真实 的 Servlet 环境 而 不 是 模拟 
的 Servlet 环境 。 其 代码 如 下 : 








cammmwmn 


@RunWith (SpringRunner.class 
@Spring BootTest (webEnvironment = Spring BootTest .WebEnvironment .DEFINED PORT) 
public class Test0lApplicationTests { 

QAutowired 

TestRestTemplate restTemplate; 

QTest 

public void test3() { 

ResponseEntity<String> hello = restTemplate.getForEntity("/hello?name={0}", 

String.class, "Michael"); 
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10 System.out .println (hello.getBody()); 











8.3.4 JSON 测试 


开发 者 可 以 使 用 @JsonTest 测试 JSON 序列 化 和 反 序列 化 是 否 工 作 正常 ， 该 注解 将 自动 配置 
Jackson ObjectMapper、(@JsonComponent 以 及 Jackson Modules。 如 果 开发 者 使 用 Gson 代 蔡 Jackson， 
该 注解 将 配置 Gson。 具 体 用 法 如 下 : 


@RunWith (SpringRunner.class) 
@JsonTest 
public class JSONTest { 
QAutowired 
JacksonTester<Book> jacksonTester; 
QTest 
public void testSerialize () throws IOException { 
Book book = new Book(); 
book.setId(1); 
0 book.setName ("三 国 演义 "); 
1 book. setAuthor ("罗贯中 ") ; 
全 RAssertions .assertThat (jacksonTester .write (book) ) 
3 .isEqualToJson ("book.json"); 
4 Assertions.assertThat (jacksonTester.write (book)) 
5 
6 
7 
8 





OooMAoODp 


.hasJsonPathStringValue ("@ .name"); 
Assertions.assertThat (jacksonTester .write (book)) 

.extractingJsonPathStringValue ("@ .name") 

.isEqualTo ("三 国 演义 ") ; 














9 } 
20 QTest 
21 public void testDeserialize() throws Exception { 
22 String content = "{\"id\":1, \"name\":\" 三 国 演义 \", \"author\":\" 罗 贯 中 \"}"; 
3 Rssertions .assertThat (jacksonTester.parseObject (content) .getName () ) 
24 .isEqualTo(" 三 国 演义 ") ; 
25 } 
26 | } 
代码 解释 : 
@ 首先 第 2 行 添加 JacksonTester 注解 ， 第 5 行 注入 JacksonTester 进行 JSON 的 序列 化 和 反 序 列 
化 测试 。 
e 第 12、13 行 在 序列 化 完成 后 判断 序列 化 结果 是 否 是 所 期 待 的 json，book.json 是 一 个 定义 在 
当前 包 下 的 JSON 文件 。 


@ 第 14、15 行 判断 对 象 序列 化 之 后 生成 的 JSON 中 是 否 有 一 个 名 为 name 的 key。 
e 第 16-18 行 判断 序列 化 后 name 对 应 的 值 是 否 为 “三 国 演义 ”。 
@ 第 23、24 行 是 反 序列 化 ， 反 序列 化 完成 时 判断 对 象 的 name 属性 值 是 否 为 “三 国 演 义 ”。 





book.json 文件 如 图 8-7 所 示 。 
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Project ~ 图 直 | 类- 乒 | 第 bookjson 


Y Msrc 1 有 id”:1, “nane” :三国 演义 ”， "author :罗贯中 本 | 





> Mmain 
v Mtest 
v Mjava 
v Blorg 
v Blsang 
Y mtest01 

轩 AppTest 
夸 JSONTest 
同 MyComponent 
@ MyWebMvcTest 





Test01ApplicationTests 


84 小 结 


本 章 向 读者 介绍 了 Spring Boot 中 的 开发 者 工具 和 单元 测试 ， 开 发 者 工具 的 一 个 核心 功能 就 是 
热 部 署 ， 结 合 LiveReload 可 以 极 大 地 缩短 开发 者 等 待 编译 的 时 间 ， 有 效 提 高 开发 效率 ;单元 测试 
则 与 Spring 单元 测试 一 脉 相 承 ， 但 是 又 增加 了 许多 功能 ， 同 时 简化 了 测试 代码 ， 使 开发 者 极 大 地 
节省 了 测试 的 编码 时 间 。 本 章 对 于 单元 测试 只 是 介绍 了 一 些 常用 功能 , 如 果 读 者 想 了 解 完整 的 单元 
测试 功能 ， 可 以 参考 Spring Boot 官方 文档 单元 测试 一 节 。 


Spring Boot 缓存 


本 章 概要 


ee Fhcache 2x 缓存 
eRedis 单机 缓存 
。 Redis 集群 缓存 


Spring 3.1 中 开始 对 缓存 提供 支持 ， 核 心思 路 是 对 方法 的 缓存 ， 当 开发 者 调用 一 个 方法 时 ， 将 
方法 的 参数 和 返回 值 作为 key/value 缓存 起 来 ， 当 再 次 调用 该 方法 时 ， 如 果 缓 存 中 有 数据 ， 就 直接 
从 缓存 中 获取 ， 和 否则 再 去 执行 该 方法 。 但 是 ，Spring 中 并 未 提供 缓存 的 实现 ， 而 是 提供 了 一 套 缓存 
API， 开 发 者 可 以 自由 选择 缓存 的 实现 ， 目 前 Spring Boot 支持 的 缓存 有 如 下 几 种 

® JCache (JSR-107) 

® EhCache2.x 

® Hazelcast 

e Infinispan 

® Couchbase 

® Redis 

e Caffeine 


e Simple 








本 章 将 介绍 目前 常用 的 缓存 实现 Ehcache 2x 和 Redis。 由 于 Spring 早已 将 缓存 领域 统一 ， 因 
此 无 论 使 用 哪 种 缓存 实现 , 不同 的 只 是 缓存 配置 ， 开发 者 使 用 的 缓存 注解 是 一 致 的 (Spring 缓存 注 
解 和 各 种 缓存 实现 的 关系 就 像 DBC 和 各 种 数据 库 驱 动 的 关系 一 样 ) 。 
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9.1 Ehcache 2.x 缓存 


Ehcache 缓存 在 Java 开发 领域 已 是 久负盛名 ， 在 Spring Boot 中 ， 只 需要 一 个 配置 文件 就 可 以 
将 Ehcache 集成 到 项 目 中 。Ehcache 2x 的 使 用 步骤 如 下 。 


1. 创建 项 目 ， 添 加 缓存 依赖 
创建 Spring Boot 项 目 ， 添 加 spring-boot-starter-cache 依赖 以 及 Ehcache 依赖 ， 代 码 如 下 


<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-cache</artifactId> 
</dependency> 
<dependency> 
<groupId>net .sf.ehcache</groupId> 
<artifactId>ehcache</artifactId> 
</dependency> 
<dependency> 
0 | <groupId>org.springframework.boot</groupId> 
11 | <artifactId>spring-boot-starter-web</artifactId> 
12 | </dependency> 


2. 添加 缓存 配置 文件 





FocoDmnamwmmwm 











如 果 Ehcache 的 依赖 存在 ， 并 且 在 classpath 下 有 一 个 名 为 ehcache.xml 的 Ehcache 配置 文件 ， 
那么 EhCacheCacheManager 将 会 自动 作为 缓存 的 实现 。 因 此 ， 在 resources 目录 下 创建 ehcache.xml 
文件 作为 Ehcache 缓存 的 配置 文件 ， 代 码 如 下 : 











1 <ehcache> 

2 <diskStore path="java.io.tmpdir/cache"/> 

3 <defaultCache 

4 maxElementsInMemory="10000" 

5 eternal="false" 

6 timeToIdleSeconds="120" 

7 timeToLiveSeconds="120" 

8 overflowToDisk="false" 

9 diskPersistent="false" 

10 diskExpiryThreadIntervalSeconds="120" 
11 /> 

12 | <cache name="book cache" 

13 maxElementsInMemory="10000" 

14 eternal="true" 

15 timeToIdleSeconds="120" 

16 timeToLiveSeconds="120" 

二 overflowToDisk="true" 

18 diskPersistent="true" 

19 diskExpiryThreadIntervalSeconds="600"/> 
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20 | </ehcache> 


这 是 一 个 常规 的 Ehcache 配置 文件 ， 提 供 了 两 个 缓存 策略 ， 一 个 是 默认 的 ， 另 一 个 名 为 
book_cache。 其 中 ，name 表示 缓存 名 称 ，maxElementsInMemory 表示 缓存 最 大 个 数 ，etemal 表示 
缓存 对 象 是 否 永 久 有 效 ， 一 旦 设置 了 永久 有 效 ，timeonut 将 不 起 作用 ; timeToIdleSeconds 表示 缓存 
对 象 在 失效 前 的 允许 闲置 时 间 (单位 : 秒 ) ， 当 etemal=false 对 象 不 是 永久 有 效 时 ,该 属性 才 生 效 ; 
timeToLiveSeconds 表示 缓存 对 象 在 失效 前 允许 存活 的 时 间 (单位 : 秒 ) ， 当 eternal=false 对 象 不 是 
永久 有 效 时 ， 该 属性 才 生 效 ; overflowToDisk 表示 当 内 存 中 的 对 象 数量 达到 maxElementsInMemory 
时 ，Ehcache 是 否 将 对 象 写 到 磁盘 中 ;diskExpiryThreadIntervalSeconds 表示 磁盘 失效 线程 运行 时 间 
间隔 .还 有 其 他 更 为 详细 的 Ehcache 配置 ,这 里 就 不 一 一 介绍 了 。 另 外 , 如果 开发 者 想 自 定义 Ehcache 
配置 文件 的 名 称 和 位 置 ， 可 以 在 application.properties 中 添加 如 下 配置 : 


由 spring.cache.ehcache.config=classpath:config/another-config.xml 
3. 开启 缓存 
在 项 目的 入 口 类 上 添加 @EnableCaching 注解 开启 缓存 ， 代 码 如 下 : 





























1 | @Sspring BootApplication 
2 | @EnableCaching 
3 | public class CacheApplication { 
4 public static void main(String[] args) { 
5 SpringApplication.run (CacheApplication.class, args); 
6 | 
人 
4. 创建 BookDao 
创建 Book 实体 类 和 BookService， 代 码 如 下 : 
1 @Repository 
2 @CacheConfig (cacheNames = "book cache") 
k} public class BookDao { 
4 QCacheable 
§ public Book getBookById(Integer id) { 
6 System.out .println ("getBookById"); 
7 Book book = new Book(); 
8 book.setId(id); 
9 book.setName ("二 BA 
10 book.setAuthor ("罗贯中 "); 
11 return book; 
Le } 
入 Q@CachePut (key = "#book.id") 
14 public Book updateBookById (Book book) { 
1 System.out .println ("updateBookById"); 
16 book.setName ( 义 2m) 7 
4 return book; 
18 } 
19 Q@CacheEvict (key = "#id") 
20 public void deleteBookById (Integer id) { 
21 System.out .println ("deleteBookById"); 
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i } 
23 1} 
24 | public class Book implements Serializable { 
25 private Integer id; 
26 private String name; 
请 private String author; 
28 // 省 略 getter/setter 
29 | } 
代码 解释 : 


e 在 BookDao 上 添加 @CacheConfig 注解 指明 使 用 的 缓存 的 名 字 ， 这 个 配置 可 选 ， 若 不 使 用 
@CacheConfig 注解 ， 则 直接 在 @Cacheable 注解 中 指明 缓存 名 字 。 

e 第 4 行 在 getBookById 方法 上 添加 @Cacheable 注解 表示 对 该 方法 进行 缓存 ， 默 认 情 况 下 ， 缓 
存 的 key 是 方法 的 参数 ， 缓 存 的 value 是 方法 的 返回 值 。 当 开发 者 在 其 他 类 中 调用 该 方法 时 ， 
首先 会 根据 调用 参数 查看 缓存 中 是 否 有 相关 数据 ， 若 有 ， 则 直接 使 用 缓存 数据 ， 该 方法 不 会 
执行 ， 否 则 执行 该 方法 ， 执 行 成 功 后 将 返回 值 缓存 起 来 ， 但 若是 在 当前 类 中 调用 该 方法 ， 则 
缓存 不 会 生效 。 

e @Cacheable 注解 中 还 有 一 个 属性 condition 用 来 描述 缓存 的 执行 时 机 ， 例 如 
@Cacheable(condition = " 咱 d%2 一 0") 表 示 当 id 对 2 取 模 为 0 时 才 进行 缓存 ， 否 则 不 缓存 。 

@ ”如 果 开发 者 不 想 使 用 默认 的 key， 也 可 以 像 第 13 行 和 第 19 行 一 样 自 定义 key， 第 13 行 表示 
缓存 的 key 为 参数 book 对 象 中 id 的 值 ， 第 19 行 表示 缓存 的 key 为 参数 id。 除 了 这 种 使 用 参 
数 定义 key 的 方式 之 外 ，Spring 还 提供 了 一 个 root 对象 用 来 生成 key， 如 表 9-1 所 示 。 


表 9-1 使 用 root 对 象 生成 key 


属性 名 称 属性 描述 用 法 示例 
当前 方法 名 
当前 方法 对 旬 


当前 方法 使 用 的 缓存 
当前 被 调用 的 对 象 oot.target 
当前 被 调用 的 对 象 的 class 


站 当前 方法 参数 数组 和 ootargs[0] 








@ “如果 这 些 key 不 能 够 满足 开发 需求 ， 开 发 者 也 可 以 自 定 义 缓存 key 的 生成 器 KeyGenerator， 
代码 如 下 : 





QComponent 
public class MyKeyGenerator implements KeyGenerator { 
@Override 
public Object generate (Object target, Method method, Object... params) { 
return Arrays.toString (params); 
} 
人 
QService 
Q@CacheConfig (cacheNames = "book_cache") 
public class BookDao { 


人 
2 
3 
4 
条 
6 
了 
8 
9 
\ 


0 
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11 @Autowired 

12 MyKeyGenerator myKeyGenerator; 

3 @Cacheable (keyGenerator = "myKeyGenerator" 
14 public Book getBookById(Integer id) { 

7 System.out .println ("getBookById"); 

16 

17 

18 return book; 

19 } 

20 | } 








camm 必 wm 








自 定义 MyKeyGenerator 实现 KeyGenerator 接口 ， 然 后 实现 该 接口 中 的 generate 方法 ， 该 方 
法 的 三 个 参数 分 别 是 当前 对 象 、 当 前 请 求 的 方法 以 及 方法 的 参数 ， 开 发 者 可 根据 这 些 信息 组 
成 一 个 新 的 key 返回 ， 返 回 值 就 是 缓存 的 key。 第 13 行 在 @Cacheable 注解 中 引用 
MyKeyGenerator 实例 即 可 。 

e 第 13 行 @CachePut 注解 一 般 用 于 数据 更 新 方法 上 ， 与 @Cacheable 注解 不 同 ， 添 加 了 
@CachePut 注解 的 方法 每 次 在 执行 时 都 不 去 检查 缓存 中 是 否 有 数据 ， 而 是 直接 执行 方法 ， 然 
后 将 方法 的 执行 结果 缓存 起 来 ， 如 果 该 key 对 应 的 数据 已 经 被 缓存 起 来 了 ， 就 会 覆盖 之 前 的 
数据 ， 这 样 可 以 避免 再 次 加 载 数据 时 获取 到 脏 数据 。 同时 ，@CachePut 具有 和 (@Cacheable 类 
似 的 属性 ， 这 里 不 再 殴 述 。 

e 第 19 行 @CacheEvict 注解 一 般 用 于 删除 方法 上 , 表示 移 除 一 个 key 对 应 的 缓存 . @CacheEvict 
注解 有 两 个 特殊 的 属性 : allEntries 和 beforeInvocation， 其 中 allEntries 表示 是 否 将 所 有 的 缓存 
数据 都 移 除 ， 默 认为 false，beforeInvocation 表示 是 否 在 方法 执行 之 前 移 除 缓存 中 的 数据 ， 默 
认为 false， 即 在 方法 执行 之 后 移 除 缓存 中 的 数据 。 


5. 创建 测试 类 
创建 测试 类 ， 对 Service 中 的 方法 进行 测试 ， 代 码 如 下 : 


@RunWith (SpringRunner.class 
Q@Spring BootTest 
public class CacheApplicationTests { 
QAutowired 
BookDao bookDao; 
QTest 
public void contextLoads () { 
bookDao .getBookById (1); 
bookDao .getBookById (1); 
bookDao.deleteBookById (1); 
Book b3 = bookDao.getBookById(1); 
System.out .println("b3:"+b3); 
Book b = new Book(); 
b.setName ("三 国 演义 "); 
b.setAuthor ("罗贯中 "); 
b.setId(1); 
bookDao .updateBookById (b); 
Book b4 = bookDao.getBookById(1); 
System.out .println("b4:"+b4); 
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20 } 
21 1} 


执行 该 方法 ， 控 制 台 打印 日 志 如 图 9-1 所 示 。 














2018-07-25 21:37:28. 494 INF0 7588 一 [ 


getBookById 

deleteBookById 

getBookById 

b3:Book {id=1，name=' 三 国 演义 " ，author=' 罗贯中 ”} 
updateBookById 
b4:Book {id=1，name=' 二 国 演义 2 ，author=' 罗贯中 *} 








图 9-1 


-开始 执行 了 两 个 查询 ， 但 是 查询 方法 只 打印 了 一 次 ， 因 为 第 二 次 使 用 了 缓存 。 接 下 来 执行 
了 删除 方法 ， 删 除 方法 执行 完 之 后 再 次 执行 查询 ， 查 询 方法 又 被 执行 了 ， 因 为 在 删除 方法 中 缓存 已 
经 被 删除 了 。 再 接 下 来 执行 更 新 方法 ， 更 新 方法 中 不 仅 更 新 数据 ， 也 更新 了 缓存 ， 所 以 在 最 后 的 查 
询 方法 中 ,查询 方法 日 志 没 打印 ,说 明 该 方法 没 执行 ， 而 是 使 用 了 缓存 中 的 数据 ， 而 缓存 中 的 数据 
已 经 被 更 新 了 。 





9.2 Redis 单机 缓存 


和 Ehcache 一 样 ， 如 果 在 classpath 下 存在 Redis 并 且 Redis 已 经 配置 好 了 ， 此 时 默认 就 会 使 用 
RedisCacheManager 作为 缓存 提供 者 。Redis 单机 使 用 步骤 如 下 。 


1. 创建 项 目 ， 添 加 缓存 依赖 
创建 Spring Boot 项 目 ， 添 加 spring-boot-starter-cache 和 Redis 依赖 ， 代 码 如 下 : 





<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-cache</artifactId> 
</dependency> 

<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 
</dependency> 

<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-data-redis</artifactId> 
<exclusions> 


FFDoeDamwm 必 wm 
上 吕 


记 
DL 


<exclusion> 
<groupId>io.lettuce</groupId> 
<artifactId>lettuce-core</artifactId> 
</exclusion> 


户 户 户 
(TR 








js 
a 
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17 | </exclusions> 
18 | </dependency> 
19 | <dependency> 
20 | <groupId>redis.clients</groupId> 
21 | <artifactId>jedis</artifactId> 
22 | </dependency> 
2. 缓存 配置 
Redis 单机 缓存 只 需要 开发 者 在 application.properties 中 进行 Redis 配置 及 缓存 配置 即 可 ， 代 码 
如 下 : 
1 | #4 缓存 配置 
2 spring.cache.cache-names=cl1,c2 
3 spring.cache.redis.time-to-live=1800s 
4 | #Redis 配置 
§ spring.redis.database=0 
6 | spring.redis.host=192.168.66.129 
spring.redis.port=6379 
8 spring.redis.password=123@456 
9 spring.redis.jedis.pool .max-active=8 
10 | spring.redis.jedis.pool.max-idle=8 
11 | spring.redis.jedis.pool.max-wait=-1lms 
12 | spring.redis.jedis.pool.min-idle=0 
代码 解释 : 
@ 第 2 行 是 配置 缓存 名 称 。Redis 中 的 key 都 有 一 个 前 级 ， 默 认 前 级 就 是 “缓存 名 ::”。 
e 第 3 行 配置 缓存 有 效 期 ， 即 Redis 中 key 的 过 期 时 间 。 
e 第 5~12 行 是 Redis 配置 ， 具 体 含义 可 以 参考 本 书 6.1 节 。 
3. 开启 缓存 


接 下 来 在 项 目 入 口 类 中 开启 缓存 ， 代 码 如 下 : 











1 | @Spring BootApplication 
2 | @EnableCaching 
3 | public class RediscacheApplication { 
4 public static void main(String[] args) { 
5 SpringApplication.run (RediscacheApplication.class, args); 
6 } 
7 | 
最 后 创建 BookDao 和 测试 的 步骤 与 9.1 节 的 第 4、5 步 一 致 ， 这 里 就 不 再 袭 述 。 


9.3 ”Redis 集群 缓存 


不 同 于 Redis 单机 缓存 ，Redis 集群 缓存 的 配置 要 复杂 一 些 ， 主 要 体现 在 配置 上 ， 缓 存 的 使 用 
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还 是 和 9.1 节 中 介绍 的 一 样 。 搭 建 Redis 集群 缓存 主要 分 为 三 个 步骤 :QD 搭建 Redis 集群 ，@ 配 置 
缓存 ，@@ 使 用 缓存 。 下 面 按照 这 三 个 步骤 向 读者 介绍 Redis 集群 缓存 的 搭建 过 程 。 


9.3.1 搭建 Redis 集群 


Redis 集群 的 搭建 过 程 在 6.1.4 小 节 已 经 介绍 过 了 ， 本 案例 中 采用 的 Redis 集群 案例 和 6.1.4 小 
节 搭 建 的 Redis 集群 一 致 ， 都 是 8 台 Redis 实例 ，4 主 4 从 ， 端 口 从 8001 到 8008， 具 体 搭建 过 程 
这 里 就 不 资 述 了 ， 读 者 可 以 参考 6.1.4 小 节 。Redis 集群 搭建 成 功 后 ， 通 过 Spring Data Redis 连接 
Redis 集群 ， 这 一 段 配置 也 和 6.1.4 小 节 中 的 一 致 ， 因 此 这 里 也 不 装 述 。 总 之 ， 读 者 需要 参考 6.1.4 
小 节 先 将 Redis 集群 搭建 成 功 ， 并 且 能 够 在 Spring Boot 中 通过 RedisTemplate 访问 成 功 。 














9.3.2 配置 缓存 


当 Redis 集群 搭建 成 功 ， 并 且 能 够 从 Spring Boot 项 目 中 访问 Redis 集群 后 ， 只 需要 进行 简单 
的 Redis 缓存 配置 即 可 ， 代 码 如 下 : 














1 @Configuration 
2 | public class RedisCacheConfig { 
3 @Autowired 
4 RedisConnectionFactory conFactory; 
5 QBean 
6 RedisCacheManager redisCacheManager() { 
Map<String, RedisCacheConfiguration> configMap = new HashMap<>(); 
8 RedisCacheConfiguration redisCacheConfig = 
9 RedisCacheConfiguration.defaultCacheConfig () 
10 .prefixKeysWith ("sang:") 
11 | .disableCachingNullValues() 
ks .entryTt] (Duration.ofMinutes (30)); 
13 configMap.put ("cl", redisCacheConfig); 
14 RedisCacheWriter cacheWriter = 
15 RedisCacheWriter.nonLockingRedisCacheWriter (conFactory); 
16 RedisCacheManager redisCacheManager = 
3 new RedisCacheManager( 
18 cacheWriter, 
19 RedisCacheConfiguration.defaultCacheConfig(), 
20 configMap); 
21 return redisCacheManager; 
22 } 
23 | } 
代码 解释 : 


ee 在 配置 Redis 集群 时 ， 已 经 向 Spring 容器 中 注册 了 一 个 JedisConnectionFactory 的 实例 ， 这 里 
将 之 注入 到 RedisCacheConfig 配置 文件 中 备用 ( RedisConnectionFactory 是 
JedisConnectionFactory 的 父 类 )。 
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@ 在 RedisCacheConfig 中 提供 RedisCacheManager 的 实例 ， 该 实例 的 构建 需要 三 个 参数 ， 第 一 
个 参数 是 一 个 cacheWiriter， 直 接 通 过 nonLockingRedisCacheWriter 方法 构造 出 来 即 可 ; 第 二 
个 参数 是 默认 的 缓存 配置 ; 第 三 个 参数 是 提前 定义 好 的 缓存 配置 。 

e@ RedisCacheManager 构造 方法 中 第 三 个 参数 是 一 个 提前 定义 好 的 缓存 参数 ， 它 是 一 个 Map 类 
型 的 参数 ， 该 Map 中 的 key 就 是 指 缓存 名 字 ，value 就 是 该 名 称 的 缓存 所 对 应 的 缓存 配置， 
例如 key 的 前 组 、 缓 存 过 期 时 间 等 ， 若 缓存 注解 中 使 用 的 缓存 名 称 不 存在 于 Map 中 ， 则 使 用 
RedisCacheManager 构造 方法 中 第 二 个 参数 所 定义 的 缓存 策略 进行 数据 缓存 。 例 如 如 下 两 个 
缓存 配置 : 





1 | acacheable(value = "cl") 
2 | ecacheable(value = "c2") 


第 1 行 的 注解 中 ，cl 存在 于 configMap 集合 中 ， 因 此 使 用 的 缓存 策略 是 configMap 集合 中 
cl 所 对 应 的 缓存 策略 ，c2 不 存在 于 configMap 集合 中 ， 因 此 使 用 的 缓存 策略 是 默认 的 缓存 
策略 。 
@ 本 案例 中 默认 缓存 策略 通过 调用 RedisCacheConfiguration 中 的 defaultCacheConfig 方法 获取 ， 
该 方法 部 分 源码 如 下 : 






public static RedisCacheConfiguration defaultCacheConfig() { 


return new RedisCacheConfiguration (Duration.ZERO, true, true, 
CacheKeyPrefix.simple(), 
SerializationPair.fromSerializer (new StringRedisSerializer()), 
SerializationPair.fromSerializer (new JdkSerializationRedisSerializer ()), 
conversionService); 


} 


和 
4 
3 
4 
5 
6 
对 
8 





由 这 一 段 源码 可 以 看 到 ， 默 认 的 缓存 过 期 时 间 为 0， 即 永 不 过 期 ; 第 二 个 参数 tue 表示 允许 

存储 null， 第 三 个 参数 true 表示 开启 key 的 前 级 ， 第 四 个 参数 表示 key 的 默认 前 组 是 “缓存 

名 ::”， 接 下 来 两 个 参数 表示 key 和 value 的 序列 化 方式 , 最 后 一 个 参数 则 是 一 个 类 型 转换 器 。 

@ 本 案例 中 第 8~12 行 是 一 个 自 定义 的 缓存 配置 ， 第 10 行 设置 了 key 的 前 级 为 “sang:”， 第 11 
行 禁 止 缓存 一 个 null， 第 12 行 设置 缓存 的 过 期 时 间 为 30 分 钟 。 


9.3.3 ”使 用 缓存 


缓存 配置 完成 后 , 接 下 来 首先 在 项 目 启动 类 中 通过 @EnableCaching 注解 开启 缓存 ,代码 如 下 : 


QSpring BootApplication 
@EnableCaching 
public class RedisclustercacheApplication { 
public static void main(String[] args) { 
SpringApplication.run (RedisclustercacheApplication.class, args); 


下 





. 
之 
3 
4 
5 
6 
时 
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然后 创建 一 个 BookDao 使 用 缓存 ， 代 码 如 下 : 





1 @Repository 

芝 public class BookDao { 

汪 @Cacheable (value = "cl") 

4 public String getBookById (Integer id) { 
5 System.out .println ("getBookById"); 

6 return "这 本 书 是 三 国 演义 "; 

时 } 

8 @CachePut (value = "cl") 

9 public String updateBookById(Integer id) { 
10 return "这 是 全 新 的 三 国 演义 "; 

11 } 

12 @CacheEvict (value = "cl" 

13 public void deleteById(Integer id) { 

14 System.out .println("deleteById"); 

15 } 

16 @Cacheable (value = "c2") 

1 public String getBookById2 (Integer id) { 
18 System.out .println ("getBookById2"); 
19 return "这 本 书 是 红楼 梦 "; 





最 后 创建 单元 测试 ， 代 码 如 下 : 


@RunWith (SpringRunner .class) 
@Spring BootTest 
public class RedisclustercacheApplicationTests { 
@Autowired 
BookDao bookDao; 
QTest 
public void contextLoads () { 
bookDao.getBookById (100); 
String book = bookDao.getBookById(100); 
System.out .println (book); 
bookDao .updateBookById (100); 
String book2 = bookDao.getBookById(100); 
System.out .println (book2); 
bookDao.deleteById(100); 
bookDao .getBookById (100); 
bookDao .getBookById2 (99); 











单元 测试 运行 结果 如 图 9-2 所 示 。 
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2018-07-26 22:55:04. 413 INF0 4004 一 [ 
getBookById 

这 本 书 是 三 国 演义 

这 是 全 新 的 三 国 演义 

deleteById 

getBookById 

getBookById2 

2018-07-26 22:55:04.737 INF0 4004 一 【 


图 9-2 



































由 单元 测试 可 以 看 到 ， 一 开始 做 了 两 次 查询 ， 但 是 查询 方法 只 调用 了 一 次 ， 因 为 第 二 次 使 用 
了 缓存 ; 接 下 来 执行 了 更 新 ， 当 更 新 成 功 后 再 去 查询 ,此 时 缓存 也 已 更 新 成 功 ; 接 下 来 执行 了 删除 ， 
删除 成 功 后 再 去 执行 查询 ， 查 询 方法 又 被 调用 ， 说 明 缓存 也 已 经 被 删除 了 ;最 后 查询 了 一 个 id 为 
99 的 记录 ， 这 次 使 用 的 是 默认 缓存 配置 。 在 Redis 服务 器 上 也 可 以 看 到 缓存 结果 ， 如 图 9-3 所 示 。 











图 9-3 


id 为 100 的 记录 使 用 的 缓存 名 为 c1， 因 此 key 的 前 级 是 “sang:”， 这 是 上 文 配置 的 ， 过 期 时 
间 还 剩 1553 秒 〈 上 文 配置 的 过 期 时 间 是 30 分 钟 ) ; 而 id 为 99 的 记录 使 用 的 缓存 名 称 为 c2， 因 此 
使 用 了 默认 的 缓存 配置 ， 默 认 的 前 级 为 “缓存 名 ::”， 即 “c2::”， 默 认 的 过 期 时 间 是 永 不 过 期 。 


94 小 结 


本 章 向 读者 介绍 了 两 种 常见 的 缓存 技术 Ehcache 和 Redis， 其 中 Redis 又 分 为 单机 缓存 和 集群 
缓存 。Ehcache 部 署 简单 ， 使 用 门槛 较 低 ， 操 作 简 便 ， 但 是 功能 较 少 ， 可 扩展 性 较 弱 ，Redis 则 需 
要 单独 部 署 服 务 器 ， 单 机 版 的 Redis 缓存 基本 上 做 到 了 开 箱 即 用 ， 集 群 版 的 Redis 缓存 虽然 配置 烦 
琐 ， 但 是 具有 良好 的 扩展 性 与 安全 性 ， 开 发 者 在 开发 中 可 根据 实际 情况 选择 不 同 的 缓存 实现 策略 。 

















Spring Boot 安全 管理 


本 章 概 要 


Spring Security 基本 配置 
基于 数据 库 的 认证 
高 级 配置 

OAuth 2 

Spring Boot 整合 Shiro 


安全 可 以 说 是 公司 的 红线 了 ， 一 般 项 目 都 会 有 严格 的 认证 和 授权 操作 ， 在 Java 开发 领域 常见 
的 安全 框架 有 Shiro 和 Spring Security。Shiro 是 一 个 轻 量 级 的 安全 管理 框架 ， 提 供 了 认证 、 授 权 、 
会 话 管 理 、 密 码 管 理 、 缓 存 管理 等 功能 ，Spring Security 是 一 个 相对 复杂 的 安全 管理 框架 ， 功 能 比 
Shiro 更 加 强大 ， 权 限 控制 细 粒 度 更 高 ， 对 OAuth 2 的 支持 也 更 友好 ， 又 因为 Spring Security 源 自 
Spring 家 族 ， 因 此 可 以 和 Spring 框架 无 颖 整合 ， 特 别 是 Spring Boot 中 提供 的 自动 化 配置 方案 ， 可 
以 让 Spring Security 的 使 用 更 加 便捷 。 本 章 将 主要 介绍 Spring Security 以 及 Shiro 在 Spring Boot 中 


的 使 用 。 


10.1 Spring Security 的 基本 配置 


Spring Boot 针对 Spring Security 提供 了 自动 化 配置 方案 , 因 








地 整合 进 Spring Boot 项 目 中 ， 这 也 是 在 Spring Boot 项 目 中 使 用 


此 可 以 使 Spring Security 非常 容易 
Spring Security 的 优势 。 
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10.1.1 基本 用 法 


基本 整合 步骤 如 下 。 
1. 创建 项 目 ， 添 加 依赖 
创建 一 个 Spring Boot Web 项 目 ， 然 后 添加 spring-boot-starter-security 依赖 即 可 ， 代 码 如 下 : 








<dependency> 

<groupId>org. springframework.boot</groupId> 
<artifactId>spring-boot-starter-security</artifactId> 
</dependency> 

<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 
</dependency> 


只 要 开发 者 在 项 目 中 添加 了 spring-boot-starter-security 依赖 ,项 目 中 所 有 资源 都 会 被 保护 起 来 。 
2. 添加 hello 接口 
接 下 来 在 项 目 中 添加 一 个 简单 的 /hello 接口 ， 内 容 如 下 : 


@RestController 
public class HelloController { 
@GetMapping ("/hello") 
public String hello() { 
return "Hello"; 


， 


oOMAoODp 








3. 启动 项 目测 试 
接 下 来 启动 项 目 ， 启 动 成 功 后 ， 访 问 /hello 接口 会 自动 跳 转 到 登录 页 面 ， 这 个 登录 页 面 是 由 
Spring Security 提供 的 ， 如 图 10-1 所 示 。 
国 Login Page x 


所 GO © localhost: 


Login with Username and Password 





User: 











Password: 
Login 





图 10-1 


默认 的 用 户 名 是 user， 默 认 的 登录 密码 则 在 每 次 启动 项 目 时 随机 生成 ， 查 看 项 目 启动 日 志 ， 
如 图 10-2 所 示 。 
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2018-07-27 17:25:36.808 IIHF0 4528 — [ main] .s.s.UserDetails 


Using generated security password: 38000dff-a45a-4a6d-adb7-871216f19286 


2018-07-27 17:25:36.980 INFO 4528 一 main] o. s. s.web.Defaul 





图 10-2 


从 项 目 启动 日 志 中 可 以 看 到 默认 的 登录 密码 ， 登 录 成 功 后 ， 用 户 就 可 以 访问 “mhello ”接口 了 。 


10.1.2 配置 用 户 名 和 密码 


如 果 开发 者 对 默认 的 用 户 名 和 密码 不 满意 , 可 以 在 application.properties 中 配置 默认 的 用 户 名 、 
密码 以 及 用 户 角 色 ， 配 置 方 式 如 下 : 


spring.security.user.name=sang 


spring.security.user.password=123 
spring.security.user.roles=admin 





当 开 发 者 在 application.properties 中 配置 了 默认 的 用 户 名 和 密码 后 ， 再 次 启动 项 目 ， 项 目 启动 
日 志 就 不 会 打印 出 随机 生成 的 密码 了 ， 用 户 可 直接 使 用 配置 好 的 用 户 名 和 密码 登录 ， 登 录 成 功 后 ， 
用 户 还 具有 一 个 角色 一 一 admin。 


10.1.3 ”基于 内 存 的 认证 


当然 ,开发 者 也 可 以 自 定义 类 继承 自 WebSecurityConfigurerAdapter, 进而 实现 对 Spring Security 
更 多 的 自 定义 配置 ， 例 如 基于 内 存 的 认证 ， 配 置 方 式 如 下 : 














1 @Configuration 
2 public class MyWebSecurityConfig extends WebSecurityConfigurerAdapter { 
3 QBean 
4 PasswordEncoder passwordEncoder() { 
5 return NoOpPasswordEncoder.getInstance(); 
6 } 
QOverride 
8 protected void configure (AuthenticationManagerBuilder auth) throws Exception { 
9 auth.inMemoryAuthentication() 
10 .withUser ("admin") .password("123") .roles ("ADMIN", "USER") 
11 -and() 
12 .withUser ("sang") .password ("123") .roles ("USER"); 
13 : 
14 | } 
代码 解释 : 


ee 自 定 义 MyWebSecurityConfig 继 承 自 WebSecurityConfigurerAdapter ， 并 重 写 
configure(AuthenticationManagerBuilder auth) 方 法 ， 在 该 方法 中 配置 两 个 用 户 ， 一 个 用 户 名 是 
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admin， 密 码 123， 具 备 两 个 角色 ADMIN 和 USER; 另 一 个 用 户 名 是 sang， 密 码 是 123， 具 
备 一 个 角色 USER。 

@ 本 案例 使 用 的 Spring Security 版 本 是 5.0.6, 在 Spring Security Sx 中 引入 了 多 种 密码 加 密 方式 ， 
开发 者 必须 指定 一 种 ， 本 案例 使 用 NoOpPasswordEncoder， 即 不 对 密码 进行 加 密 。 


基于 内 存 的 用 户 配置 在 配置 角色 时 不 需要 添加 “ROLE ”前 级， 这 点 和 10.2 节 中 基于 数据 
库 的 认证 有 差别 。 





配置 完成 后 ， 重 启 Spring Boot 项 目 ， 就 可 以 使 用 这 里 配置 的 两 个 用 户 进行 登录 了 。 


10.1.4 HttpSecurity 


虽然 现在 可 以 实现 认证 功能 ， 但 是 受 保护 的 资源 都 是 默认 的 ， 而 且 也 不 能 根据 实际 情况 进行 
角色 管理 ， 如 果 要 实现 这 些 功 能 ， 就 需要 重 写 WebSecurityConfigurerAdapter 中 的 另 一 个 方法 ， 代 
码 如 下 : 











1 @Configuration 

2 | public class MyWebSecurityConfig extends WebSecurityConfigurerAdapter { 
3 QBean 

4 PasswordEncoder passwordEncoder() { 

5 return NoOpPasswordEncoder.getInstance(); 

6 } 

QOverride 

8 protected void configure (AuthenticationManagerBuilder auth) throws Exception { 
9 auth.inMemoryAuthentication() 

10 .WithUser ("root") .password ("123") .roles ("ADMIN", "DBA") 
11 .and() 

12 .withUser ("admin") .password("123") .roles ("ADMIN", "USER") 
13 .and() 

14 .withUser ("sang") .password ("123") .roles ("USER"); 

439 } 

16 QOverride 

FE protected void configure (HttpSecurity http) throws Exception { 

18 http.authorizeRequests () 

19 .antMatchers ("/admin/**") 

20 .hasRole ("ADMIN") 

2 .antMatchers ("/user/**") 

22 .access ("hasAnyRole ('ADMIN', 'USER')") 

23 .antMatchers ("/db/**") 

24 .access ("hasRole('ADMIN') and hasRole('DBA')") 

25 .anyRequest () 

26 .authenticated() 

27 .and() 

28 .formLogin () 

29 .loginProcessingUr]l ("/login") 

30 .permitAll () 
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31 -and() 
32 .csrf() 
33 .disable(); 
34 } 
3 
代码 解释 : 


CE 








@ 首先 配置 了 三 个 用 户 ，root 用 户 具 备 ADMIN 和 DBA 的 角色 ，admin 用 户 具备 ADMIN 和 
USER 的 角色 ，sang 用 户 具备 USER 的 角色 。 

e 第 18 行 调用 authorizeRequests0 方 法 开启 HttpSecurity 的 配置 , 第 19~24 行 配置 分 别 表示 用 户 
访问 “/admin/**” 模 式 的 URL 必须 具备 ADMIN 的 角色 ; 用 户 访问 “/user/**” 模 式 的 URL 
必须 具备 ADMIN 或 USER 的 角色 ; 用 户 访问 “/db/**” 模 式 的 URL 必须 具备 ADMIN 和 DBA 
的 角色 。 

日 第 25、26 行 表示 除了 前 面 定义 的 URL 模式 之 外 ， 用 户 访问 其 他 的 URL 都 必须 认证 后 访问 

(登录 后 访问 )。 
@ 第 27~30 行 表示 开局 表单 登录 ， 即 读者 一 开始 看 到 的 登录 页 面 ， 同 时 配置 了 登录 接口 为 
“/login”， 即 可 以 直接 调用 “/login” 接 口 ， 发 起 一 个 POST 请 求 进行 登录 ， 登 录 参 数 中 用 户 
名 必须 命名 为 usemame， 密 码 必须 命名 为 password， 配 置 loginProcessingUrl 接口 主要 是 方便 
Ajax 或 者 移动 端 调用 登录 接口 。 最 后 还 配置 了 permitAll, 表示 和 登录 相关 的 接口 都 不 需要 认 
证 即 可 访问 。 
@ 第 32、33 行 表示 关闭 csrf。 


配置 完成 后 ， 接 下 来 在 Controller 中 添加 如 下 接口 进行 测试 : 


@RestController 
public class HelloController { 
@GetMapping ("/admin/hello") 
public String admin() { 
return "hello admin!"; 


@GetMapping ("/user/hello") 
public String user() { 
return "hello user!"; 


Q@GetMapping ("/db/hello") 
public String dba() { 
return "hello dba!"; 


Q@GetMapping ("/hello") 
public String hello() { 
return "hello"; 








根据 上 文 的 配置 ，“/admin/hello” 接 口 root 和 admin 用 户 具 有 访问 权限 ; “/user/hello” 接 口 


admin 和 sang 用 户 具有 访问 权限 ; “/db/hello” 路 径 则 只 有 root 用 户 具有 访问 权限 。 浏 览 器 中 的 测 
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试 比 较 容易 ， 这 里 不 再 袭 述 。 





10.1.5 ”登录 表单 详细 配置 


迄今 为 止 ， 登录 表 单一 直 使 用 Spring Security 提供 的 页 面 ， 登 录 成 功 后 也 是 默认 的 页 面 跳 转 ， 
但 是 , 前 后 端 分 离 正 在 成 为 企业 级 应 用 开发 的 主流 ,在 前 后 端 分 离 的 开发 方式 中 ,前 后 端的 数据 交 
互通 过 JSON 进行 , 这 时 ,登录 成 功 后 就 不 是 页 面 跳 转 了 , 而 是 一 段 JSON 提示 。 要 实现 这 些 功能 ， 
只 需要 继续 完善 上 文 的 配置 ， 代 码 如 下 : 











1 .and() 

肥 .formLogin() 

3 .loginPage ("/login page") 

4 .loginProcessingUrl ("/login") 

入 .usernameParameter ("name") 

6 .passwordParameter ("passwd") 

7 .successHandler (new AuthenticationSuccessHandler() { 

8 QOverride 

9 public void onAuthenticationSuccess (HttpServletRequest req, 
0 HttpServletResponse resp, 

1 Authentication auth) 

Fs throws IOException { 

3 | Object principal = auth.getPrincipal (); 

4 resp.setContentType ("application/json;charset=utf-8"); 
$s PrintWriter out = resp.getWriter(); 

6 resp.setStatus (200); 

7 Map<String, Object> map = new HashMap<>(); 

8 map.put ("status", 200); 

9 map.put ("msg", principal); 

20 ObjectMapper om = new ObjectMapper (); 

a out .write (om.writeValueAsString (map)); 

22 out.flush(); 

党 3 out.close(); 

24 } 

25 | }) 

26 | .failureHandler (new AuthenticationFailureHandler() { 

29 QOverride 

28 public void onAuthenticationFailure (HttpServletRequest req, 
29 HttpServletResponse resp, 
30 AuthenticationException e) 
31 throws IOException { 

KE resp.setContentType ("application/json;charset=utf-8"); 
33 PrintWriter out = resp.getWriter(); 

34 Tesp.setStatus (401); 

35 Map<String, Object> map = new HashMap<>(); 

36 map.put ("status", 401); 

37 if (e instanceof LockedException) { 

38 map.put ("msg"，" 账 户 被 锁定 ， 登 录 失 败 !") ; 

39 } else if (e instanceof BadCredentialsException) { 
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40 map.put ("msg"，" 账 户 名 或 密码 输入 错误 ， 登 录 失 败 !") ; 
41 } else if (e instanceof DisabledException) { 

42 map.put ("msg"，" 账 户 被 禁用 ， 登 录 失 败 !") ; 

43 } else if (e instanceof AccountExpiredException) { 
44 map.put ("msg"， "账户 已 过 期 ， 登 录 失 败 !") ; 

45 } else if (e instanceof CredentialsExpiredException) { 
46 map.put ("msg"，" 密 码 已 过 期 ， 登 录 失 败 !") ; 

47 jelsef 

48 map.put ("msg"，" 登 录 失 败 !") ; 

49 } 

50 ObjectMapper om = new ObjectMapper (); 

51 out .write (om.writeValueAsString (map)); 

52 out.flush(); 

53 out.close(); 

54 } 

55 | 1) 

56 | .permitAll () 

57 | .and() 





代码 解释 : 


e 第 3 行 配置 了 loginPage， 即 登录 页 面 ， 配置 了 loginPage 后 ， 如 果 用 户 未 获 授权 就 访问 一 个 
需要 授权 才能 访问 的 接口 ， 就 会 自动 跳 转 到 login page 页 面 让 用 户 登 录 ， 这 个 login page 就 
是 开发 者 自 定义 的 登录 页 面 ， 而 不 再 是 Spring Security 提供 的 默认 登录 页 。 

e 第 4 行 配置 了 loginProcessingUrl， 表 示 登 录 请 求 处 理 接口 ， 无 论 是 自 定义 登录 页 面 还 是 移动 
端 登录 ， 都 需要 使 用 该 接口 。 

@ 第 5、6 行 定义 了 认证 所 需 的 用 户 名 和 密码 的 参数 名 ， 默 认 用 户 名 参数 是 username， 密 码 参 
数 是 password， 可 以 在 这 里 自 定义 。 

日 第 7-25 行 定义 了 登录 成 功 的 处 理 远 辑 。 用 户 登录 成 功 后 可 以 跳 转 到 菜 一 个 页 面 ， 也 可 以 返 
回 一 段 JSON， 这 个 要 看 具体 业务 过 辑 ， 本 案例 假设 是 第 二 种 ， 用 户 登 录 成 功 后 ， 返 回 一 段 
登录 成 功 的 JSON。onAuthenticationSuccess 方法 的 第 三 个 参数 一 般 用 来 获取 当前 登录 用 户 的 
信息 ， 在 登录 成 功 后 ， 可 以 获取 当前 登录 用 户 的 信息 一 起 返回 给 客户 端 。 

@ 第 26-54 行 定义 了 登录 失败 的 处 理 远 辑 ， 和 登录 成 功 类 似 ， 不 同 的 是 ， 登 录 失 败 的 回调 方法 
里 有 一 个 AuthenticationException 参数 ， 通过 这 个 异常 参数 可 以 获取 登录 失败 的 原因 ， 进而 给 
用 户 一 个 明确 的 提示 。 

配置 完成 后 ， 使 用 Postman 进行 登录 测试 ， 如 图 10-3 所 示 。 


登录 请 求 参数 用 户 名 是 name， 密 码 是 passwd， 登 录 成 功 后 返回 用 户 的 基本 信息 ， 密 码 已 经 过 
滤 掉 了 。 如 果 登 录 失 败 ， 也 会 有 相应 的 提示 ， 如 图 10-4 所 示 。 
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f 
1 


POST 7 http://localhost:8080/login?name=admin&passwd=123 
Pretty JSON 巴 

2 "mse": { 

3 "password": null, 

一 "username": "admin"， 

5 "authorities": [ 


"authority": “ROLE_ADMIN” 


- }, 

7 { 

19 "authority": "ROLE_USER" 
11 } 

12 ]， 

13 ”accountNonExpired": true， 

14 "accountNonLocked": true, 

15 "credentialsNonExpired": true, 
16 "enabled": true 

17 }, 

18 "status": 200 








图 10-3 


"msg": “账户 名 或 密码 输入 错误 ， 登 录 失 败 !"， 


"status": 401 





10.1.6 ”注销 登录 配置 


如 果 想 要 注销 登录 ， 也 只 需要 提供 简单 的 配置 即 可 ， 代 码 如 下 : 








.and() 
.logout () 
.logoutUrl ("/logout") 
.ClearAuthentication (true) 
.invalidateHttpSession (true) 
.addLogoutHandler (new LogoutHandler() { 
QOverride 
public void logout (HttpServletRequest reqg, 
HttpServletResponse resp, 
10 Authentication auth) { 


上 吕 Down 
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12 
13 
14 
15 
16 
17 
18 
19 





}) 
.logoutSuccessHandler (new LogoutSuccessHandler() { 
QOverride 
public void onLogoutSuccess (HttpServletRequest reqg, 
HttpServletResponse resp, 
Authentication auth) 


throws IOException { 
resp.sendRedirect ("/login page"); 





代码 解释 : 

第 2 行 表示 开启 注销 登录 的 配置 。 

第 3 行 表示 配置 注销 登录 请 求 URL 为 “/logout”"， 默 认 也 是 “/logout”。 

第 4 行 表示 是 否 清除 身份 认证 信息 ， 默 认为 tue， 表 示 清 除 。 

第 5 行 表示 是 否 使 Session 失效 ， 默 认为 true。 

第 6 行 配置 一 个 LogoutHandler， 开 发 者 可 以 在 LogoutHandler 中 完成 一 些 数据 清除 工作 ， 例 

如 Cookie 的 清除 。Spring Security 提供 了 一 些 常见 的 实现 ， 如 图 10-5 所 示 。 

e 第 13 行 配置 一 个 LogoutSuccessHandler， 开 发 者 可 以 在 这 里 处 理 注销 成 功 后 的 业务 逻辑 ， 例 
如 返回 一 段 JSON 提示 或 者 跳 转 到 登录 页 面 等 。 


LogoutHandler (org.springframework security t 
篇 CookieClearingLogoutHandler (org.springframework.security.web.authentication.logout) 
和 = csrfLogoutHandler (org.springframework.security.web.csr) 

乱  CompositeLogoutHandler (org.springframework.security.web.authentication.logout) 


LAbstractRememberMeServices (org.springframework.security.web.authentication.rememberme) 


网 PersistentTokenBasedRememberMeServices (org.springframework.security.web.authentication.rememberme) 
网 TokenBasedRememberMeServices (org.springframework.security,web.authentication.rememberme) 





网 8 SecurityContextLogoutHandler (org.springframework.security.web.authentication.logout) 


图 10-5 


10.1.7 多 个 HttpSecurity 














如 果 业 务 比 较 复杂 ,开发 者 也 可 以 配置 多 个 HttpSecurity, 实现 对 WebSecurityConfigurerAdapter 


的 多 次 扩展 ， 代 码 如 下 : 





1 
2 
a 
4 
5 
6 
时 
8 
3 


@Configuration 
public class MultiHttpSecurityConfig{ 
Q@Bean 
PasswordEncoder passwordEncoder() { 
return NoOpPasswordEncoder.getInstance(); 
} 
QAutowired 
protected void configure (AuthenticationManagerBuilder auth) throws Exception { 
auth.inMemoryAuthentication() 
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10 -withUser("admin") .password("123") .roles ("ADMIN", "USER") 
3 -and() 

12 .withUser ("sang") .password("123") .roles ("USER"); 

13 让 

14 QConfiguration 

5 @Order (1) 

16 public static class AdminSecurityConfig extends WebSecurityConfigurerAdapter{ 
17 @Override 

18 protected void configure (HttpSecurity http) throws Exception { 
19 http.antMatcher ("/admin/**") .authorizeRequests () 

20 .anyRequest () .hasRole ("ADMIN"); 

必 } 

22 } 

23 @Configuration 

24 public static class OtherSecurityConfig extends WebSecurityConfigurerAdapter{ 
25 QOverride 

26 protected void configure (HttpSecurity http) throws Exception { 
27 http.authorizeRequests () 

28 .anyRequest () .authenticated () 

29 .and() 

30 .formLogin () 

31 .loginProcessingUrl ("/login") 

32 .permitAll () 

| .and() 

34 .Csrf () 

35 .disable(); 

36 } 

37 } 

38 | } 





代码 解释 : 





ee 配置 多 个 HttpSecurity 时 , MultiHttpSecurityConfig 不 需要 继承 WebSecurityConfigurerAdapter， 
在 MultiHttpSecurityConfig 中 创建 静态 内 部 类 继承 WebSecurityConfigurerAdapter 即 可 ， 静 态 
内 部 类 上 添加 @Configuration 注解 和 @Order 注解 ，@Order 注解 表示 该 配置 的 优先 级 ， 数 字 
越 小 优先 级 越 大 ， 未 加 @Order 注解 的 配置 优先 级 最 小 。 

@ 第 14-22 行 配置 表示 该 类 主要 用 来 处 理 “/admin/**” 模 式 的 URL, 其 他 的 URL 将 在 第 23~37 


行 配置 的 HttpSecurity 中 进行 处 理 。 


10.1.8 ”密码 加 密 


1. 为 什么 要 加 密 


2011 年 12 月 21 日 有 人 在 网 络 上 公开 了 一 个 包含 600 
全 部 为 明文 存储 ,包含 用 户 名 、 密 码 以 及 注册 邮箱 。 事 件 发 


万 个 CSDN 用 户 资料 的 数据 库 ， 数 据 
E 后 ，CSDN 在 微 博 、 官 方 网 站 等 渠道 





发 出 了 声明 ， 解 释 说 此 数据 库 是 2009 年 备份 所 用 的 ， 因 不 明 原 因 泄 露 ， 已 经 向 警方 报案 ， 后 又 在 








官网 发 出 了 公开 道歉 信 。 在 接 下 来 的 十 多 天 里 ， 金 山 、 网 易 、 





京东 、 当 当 、 新 浪 等 多 家 公司 被 卷 入 
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这 次 事件 中 。 整 个 事件 中 最 触目 惊 心 的 莫 过 于 CSDN 把 用 户 密码 明文 存储 ， 由 于 很 多 用 户 是 多 个 
网 站 共用 一 个 密码 ,因此 一 个 网 站 密码 泄露 就 会 造成 很 大 的 安全 隐患 。 有 了 这 么 多 前 车 之 鉴 ,我 们 
现在 做 系统 时 ， 密 码 都 要 加 密 处 理 。 


2. 加 密 方案 


密码 加 密 一 般 会 用 到 散 列 函数 ， 又 称 散 列 算法 、 哈 希 函数 ， 这 是 一 种 从 任何 数据 中 创建 数字 
“指纹 ”的 方法 。 散 列 函 数 把 消息 或 数据 压缩 成 摘要 ， 使 得 数据 量变 小 ， 将 数据 的 格式 固定 下 来 ， 
然后 将 数据 打 乱 混合 , 重新 创建 一 个 散 列 值 。 散 列 值 通常 用 一 个 短 的 随机 字母 和 数字 组 成 的 字符 串 
来 代表 。 好 的 散 列 函数 在 输入 域 中 很 少 出 现 散 列 冲突 。 在 散 列表 和 数据 处 理 中 ,不 抑制 冲突 来 区 别 
数据 会 使 得 数据 库 记 录 更 难 找到 。 我 们 常用 的 散 列 函数 有 MDS5 消息 摘要 算法 、 安 全 散 列 算法 
(Secure Hash Algorithm) 。 

但 是 仅仅 使 用 散 列 函 数 还 不 够 ， 为 了 增加 密码 的 安全 性 ， 一 般 在 密码 加 密 过 程 中 还 需要 加 盐 ， 
所 谓 的 盐 可 以 是 一 个 随机 数 ， 也 可 以 是 用 户 名 ， 加 盐 之 后 ， 即 使 密码 明文 相同 的 用 户 生 成 的 密码 ， 
密 文 也 不 相同 , 这 可 以 极 大 地 提高 密码 的 安全 性 。 但 是 传统 的 加 盐 方式 需要 在 数据 库 中 有 专门 的 字 
段 来 记录 盐 值 ， 这 个 字段 可 能 是 用 户 名 字段 (因为 用 户 名 唯一 ) ， 也 可 能 是 一 个 专门 记录 盐 值 的 字 
段 ， 这 样 的 配置 比较 烦琐 。 Spring Security 提供 了 多 种 密码 加 密 方 案 ， 官方 推 荐 使 用 
BCryptPasswordEncoder，BCryptPasswordEncoder 使 用 BCrypt 强 哈 希 函数 , 开发 者 在 使 用 时 可 以 选 
择 提供 strength 和 SecureRandom 实例 。strength 越 大 ， 密 钥 的 迭代 次 数 越 多 ， 密 钥 迭 代 次 数 为 
2^strength。strength 取 值 在 4-31 之 间 ， 默 认为 10。 


3. 实践 


在 Spring Boot 中 配置 密码 加 密 非 常 容 易 ， 只 需要 修改 上 文 配置 的 PasswordEncoder 这 个 Bean 
的 实现 即 可 ， 代 码 如 下 : 


Q@Bean 
PasswordEncoder passwordEncoder () { 





return new BCryptPasswordEncoder (10) 


J 





创建 BCryptPasswordEncoder 时 传 入 的 参数 10 就 是 stength， 即 密 钥 的 途 代 次 数 〈 也 可 以 不 配 

置 ， 默 认为 10) 。 同 时 ， 配 置 的 内 存 用 户 的 密码 也 不 再 是 123 了 ， 代 码 如 下 : 
auth.inMemoryAuthentication() 

.withUser ("admin") 

.password ("$2a$10$RMuFXGQS5AtHAwOvkUqyvuecpqUSeoxZYqilXzbz50dceRsga.WYiq") 

.roles ("ADMIN", "USER") 

-and() 

.WithUser ("sang") 

.password ("$2a$10$eUHPbAOMqAbpxTvOVz33LIehLe3fu6NwqC9tdOcxJXEhyZ4simqXTC") 

.roles ("USER"); 


这 里 的 密码 就 是 使 用 BCryptPasswordEncoder 加 密 后 的 密码 ， 虽 然 admin 和 sang 加 密 后 的 密 
码 不 一 样 ， 但 是 明文 都 是 123。 配 置 完成 后 ， 使 用 admin/123 或 者 sang/123 就 可 以 实现 登录 。 本 案 
例 使 用 了 配置 在 内 存 中 的 用 户 ， 一 般 情 况 下 , 用 户 信息 是 存储 在 数据 库 中 的 ， 因 此 需要 在 用 户 注册 
时 对 密码 进行 加 密 处 理 ， 代 码 如 下 : 








oOoODPp 
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QService 
public class RegService { 
public int reg(String username, String password) { 
BCryptPasswordEncoder encoder = new BCryptPasswordEncoder (10); 
String encodePasswod = encoder.encode (password); 
return saveToDb (username, encodePasswod); 


co Dawmmwm 








} 


用 户 将 密码 从 前 端 传 来 之 后 ， 通 过 调用 BCryptPasswordEncoder 实例 中 的 encode 方法 对 密码 
进行 加 密 处 理 ， 加 密 完成 后 将 密 文 存 入 数据 库 。 





10.1.9 方法 安全 


上 文 介绍 的 认证 与 授权 都 是 基于 URL 的 ， 开 发 者 也 可 以 通过 注解 来 灵活 地 配置 方法 安全 ， 要 
使 用 相关 注解 ， 首 先 要 通过 @EnableGlobalMethodSecurity 注解 开启 基于 注解 的 安全 配置 


Q@Configuration 
QEnableGlobalMethodSecurity (prePostEnabled = true, securedEnabled = true) 


public class WebSecurityConfig{ 
} 





代码 解释 : 

® prePostEnabled=true 会 解锁 @PreAuthorize 和 (@PostAuthorize 两 个 注解 ， 顾 名 思 义 ， 
(@PreAuthorize 注解 会 在 方法 执行 前 进行 验证 ， 而 @PostAuthorize 注解 在 方法 执行 后 进行 验 
证 。 

® securedEnabled=true 会 解锁 @Secured 注解 。 


开启 注解 安全 配置 后 ， 接 下 来 创建 一 个 MethodService 进行 测试 ， 代 码 如 下 : 





1 | aservice 

2 public class MethodService { 

3 @Secured ("ROLE ADMIN") 

4 public String admin() { 

5 return "hello admin"; 

6 } 

7 @PreAuthorize ("hasRole('ADMIN') and hasRole('DBA')") 
8 public String dba() { 

9 return "hello dba"; 

10 } 

YL Q@PreAuthorize ("hasAnyRole ('ADMIN', 'DBA', 'USER') ") 
12 public String user() { 

13 return "user"7 

14 } 

15 | } 
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代码 解释 : 

ee @Secured("ROLE _ ADMIN) 注解 表示 访问 该 方法 需要 ADMIN 角色 ， 注 意 这 里 需要 在 角色 前 
加 一 个 前 级 “ROLE ”。 

® (@PreAuthorize("hasRole(ADMIN) and hasRole(DBA')") 注 解 表 示 访 问 该 方法 既 需 要 ADMIN 
角色 又 需要 DBA 角色 。 

®  (@PreAuthorize("hasAnyRole('ADMIN''DBA''USER')") 表 示 访 问 该 方法 需要 ADMIN、DBA 或 
USER 角色 。 

。 @PreAuthorize 和 @PostAuthorize 中 都 可 以 使 用 基于 表达 式 的 语法 。 


最 后 ， 在 Controller 中 注入 Service 并 调用 Service 中 的 方法 进行 测试 ， 这 里 比较 简单 ， 读 者 可 
以 自行 测试 。 


10.2 ”基于 数据 库 的 认证 


上 文 向 读者 介绍 的 认证 数据 都 是 定义 在 内 存 中 的 ， 在 真实 项 目 中 ， 用 户 的 基本 信息 以 及 角色 
等 都 存储 在 数据 库 中 , 因此 需要 从 数据 库 中 获取 数据 进行 认证 。 本 节 将 向 读者 介绍 如 何 使 用 数据 库 
中 的 数据 进行 认证 和 授权 。 

1. 设计 数据 表 

首先 需要 设计 一 个 基本 的 用 户 角色 表 ， 如 图 10-6 所 示 。 一 共 三 张 表 ， 分 别 是 用 户 表 、 角 色 表 
以 及 用 户 角色 关联 表 。 为 了 方便 测试 ， 预 置 几 条 测试 数据 ， 如 图 10-7 所 示 。 





月 id: int(11) 2 id: int(11 
username: varchar(32) name: varchar(32) 
password: varchar(255) namezh- varchar(32) 
enabled: tinyint!l 
locked: tinyint(]) 


user_role 











图 10-6 
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图 10-7 





角色 名 有 一 个 默认 的 前 级 “ROLE ”。 





2. 创建 项 目 
MyBatis 灵活 ，JPA 便利 ， 本 案例 选择 前 者 ， 因 此 创建 Spring Boot Web 项 目 添加 如 下 依赖 : 





<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-security</artifactId> 
</dependency> 

<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 


</dependency> 
<dependency> 
0 | <groupId>org.mybatis.spring.boot</groupId> 
11 | <artifactId>mybatis-spring-boot-starter</artifactId> 


FoeDmnnamwmmwm 


12 | <version>1.3.2</version> 

13 | </dependency> 

14 | <dependency> 

15 | <groupId>mysql</groupId> 

16 | <artifactId>mysql-connector-java</artifactId> 
17 | <scope>runtime</scope> 

18 | </dependency> 

19 | <dependency> 

20 | <groupId>com.alibaba</groupId> 
21 | <artifactId>druid</artifactId> 
22 | <version>1.1.10</version> 

23 | </dependency> 
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3. 配置 数据 库 
在 application.properties 中 进行 数据 库 连 接 配置 : 




















1 | spring.datasource.type=com.alibaba.druid.pool .DruidDataSource 
spring.datasource.username=root 
入 spring.datasource.password=root 
4 | spring.datasource.url=jdbc:mysql:///security 
4. 创建 实体 类 
分 别 创建 角色 表 和 用 户 表 对 应 的 实体 类 ， 代 码 如 下 : 
1 public class Role { 
芝 private Integer id; 
3 private String name; 
4 private String nameZh; 
5 // 省 略 getter/setter 
6 } 
7 |public class User implements UserDetails { 
8 private Integer id; 
9 private String username; 
0 private String password; 
1 private Boolean enabled; 
2 private Boolean locked; 
3 private List<Role> roles; 
4 Override 
5 public Collection<? extends GrantedRAuthority> getAuthorities() { 
6 List<SimpleGrantedAuthority> authorities = new ArrayList<>(); 
7 for (Role role : roles) { 
8 authorities.add (new SimpleGrantedAuthority (role.getName())); 
9 y 
20 return authorities; 
21 
22 QOverride 
23 public String getPassword() { 
24 return password; 
25 
26 QOverride 
27 public String getUsername () { 
28 return username; 
29 
30 QOverride 
31 public boolean isAccountNonExpired() { 
32 return true; 
33 
34 QOverride 
35 public boolean isAccountNonLocked() { 
36 return !locked; 
37 
38 QOverride 
39 public boolean isCredentialsNonExpired() { 
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40 return true; 
41 } 
42 QOverride 
43 public boolean isEnabled() { 
44 return enabled; 
45 } 
46 // 省 略 getter/setter 
47 | } 
代码 解释 : 


e@ 用户 实体 类 需要 实现 UserDetails 接口 ， 并 实现 该 接口 中 的 7 个 方法 ， 如 表 10-1 所 示 。 


表 10-1 UserDetails 接口 的 7 个 方法 








方法 名 解释 

getAuthorities0; 获取 当前 用 户 对 象 所 具有 的 角色 信息 
getPasswordO:; 获取 当前 用 户 对 象 的 密码 
getUsemame(); 获取 当前 用 户 对 象 的 用 户 名 
isAccountNonExpiredO: 当前 账户 是 否 未 过 期 
isAccountNonLockedO: 当前 账户 是 否 未 锁定 
isCredentialsNonExpiredO:; 当前 账户 密码 是 否 未 过 期 
isEnabled0):; 当前 账户 是 否 可 用 


@ ”用 户 根据 实际 情况 设置 这 7 个 方法 的 返回 值 。 因 为 默认 情况 下 不 需要 开发 者 自己 进行 密码 角 
色 等 信息 的 比 对 ， 开 发 者 只 需要 提供 相关 信息 即 可 ， 例 如 getPassword() 方 法 返回 的 密码 和 用 
户 输入 的 登录 密码 不 匹配 , 会 自动 抛 出 BadCredentialsException 异常 ，isAccountNonExpired0 
方法 返回 了 false, 会 自动 抛 出 AccountExpiredException 异常 ， 因 此 对 开发 者 而 言 ， 只 需要 按 
照 数据 库 中 的 数据 在 这 里 返回 相应 的 配置 即 可 。 本 案例 因为 数据 库 中 只 有 enabled 和 locked 
字段 ， 故 账户 未 过 期 和 密码 未 过 期 两 个 方法 都 返回 true。 

® ”getAuthorities0 方 法 用 来 获取 当前 用 户 所 具有 的 角色 信息 ， 本 案例 中 ,， 用户 所 具有 的 角色 存储 
在 roles 属性 中 ， 因 此 该 方法 直接 遍历 roles 属性 ， 然 后 构造 SimpleGrantedAuthority 集合 并 返 
回 。 


5. 创建 UserService 
接 下 来 创建 UserService， 代 码 如 下 : 








FeDamwmmwmh 


So 


QService 
public class UserService implements UserDetailsService { 
QAutowired 
UserMapper userMapper; 
QOverride 
public UserDetails loadUserByUsername (String username) throws 
UsernameNotFoundException { 
User user = userMapper.1loadUserByUsername (username); 
if (user == null) { 
throw new UsernameNotFoundException (" 账 户 不 存在 !") ; 











第 10 章 Spring Boot 安全 管理 | 181 
































11 } 
12 user.setRoles (userMapper .getUserRolesByUid (user.getId())); 
13 return user; 
14 } 
15 | } 
代码 解释 : 
@ 定义 UserService 实现 UserDetailsService 接口 ,并 实现 该 接口 中 的 loadUserByUsermame 方法 ， 
该 方法 的 参数 就 是 用 户 登 录 时 输入 的 用 户 名 ， 通 过 用 户 名 去 数据 库 中 查找 用 户 ， 如 果 没 有 查 
找到 用 户 ， 就 抛 出 一 个 账户 不 存在 的 异常 ， 如 果 查 找到 了 用 户 ， 就 继续 查找 该 用 户 所 具有 的 
角色 信息 ， 并 将 获取 到 的 user 对 象 返回 ， 再 由 系统 提供 的 DaoAuthenticationProvider 类 去 比 
对 密码 是 否 正确 。 
@ loadUserByUsemame 方法 将 在 用 户 登录 时 自动 调用 。 
当然 ， 这 里 还 涉及 UserMapper 和 UserMapper.xml， 相 关 源 码 如 下 : 
于 @Mapper 
2 | public interface UserMapper { 
3 User loadUserByUsername (String username); 
4 List<Role> getUserRolesByUid(Integer id); 
5 } 
6 <!DOCTYPE mapper 
7 PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
8 | "http://mybatis.org/dtd/mybatis-3-mapper.dtd"> 
9 <mapper namespace="org.sang.security02.mapper.UserMapper"> 
10 | <select id="loadUserByUsername" resultType="org.sang.security02.model .User"> 
11 select * from user where username=#{username} 
12 | </select> 
13 | <select id="getUserRolesByUid" resultType="org.sang.security02.model.Role"> 
14 select * from role r,user role ur where r.id=ur.rid and ur.uid=#{id} 
15 | </select> 
16 | </mapper> 
6. 配置 Spring Security 
接 下 来 对 Spring Security 进行 配置 ， 代 码 如 下 : 
1 @Configuration 
EP public class WebSecurityConfig extends WebSecurityConfigurerAdapter { 
和 QAutowired 
4 UserService userService; 
5 Q@Bean 
6 PasswordEncoder passwordEncoder () { 
了 return new BCryptPasswordEncoder (); 
8 } 
9 QOverride 
10 protected void configure (AuthenticationManagerBuilder auth) throws Exception { 
得 auth.userDetailsService (userService); 
12 } 
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14 QOverride 

15 protected void configure (HttpSecurity http) throws Exception { 
16 http.authorizeRequests () 

17 .antMatchers("/admin/**") .hasRole ("admin") 
18 -antMatchers ("/db/**") .hasRole ("dba") 

19 .antMatchers ("/user/**") .hasRole ("user") 
20 .anyRequest () .authenticated() 

21 -and() 

a .formLogin () 

23 .loginProcessingUrl ("/login") .permitRll() 
24 .and() 

25 .Csrf() .disable(); 

26 } 

六 





这 里 大 部 分 配置 和 10.1 节 介 绍 的 一 致 ， 唯 一 不 同 的 是 没有 配置 内 存 用 户 ， 而 是 将 刚刚 创建 好 





的 UserService 配置 到 AuthenticationManagerBuilder 中 。 
配置 完成 后 ， 接 下 来 就 可 以 创建 Controller 进行 测试 了 ,测试 方式 与 10.1 节 一 致 ,这 里 不 再 资 





10.3 ”高 级 配置 


10.3.1 角色 继承 


在 10.2 节 的 案例 中 定义 了 三 种 角色 ， 但 是 这 三 种 角色 之 间 不 具备 任何 关系 ， 一 般 来 说 角色 之 
间 是 有 关系 的 ， 例 如 ROLE_admin 一 般 既 具有 admin 的 权限 ， 又 具有 user 的 权限 。 那 么 如 何 配置 
这 种 角色 继承 关系 呢 ? 在 Spring Security 中 只 需要 开发 者 提供 一 个 RoleHierarchy 即 可 。 以 10.2 中 
的 案例 为 例 ， 假 设 ROLE dba 是 终极 大 Boss， 具 有 所 有 的 权限 ，ROLE admin 具有 ROLE user 的 
权限 ，ROLE_user 则 是 一 个 公共 角色 ， 即 ROLE admin 继承 ROLE user、ROLE dba 继承 
ROLE admin， 要 描述 这 种 继承 关系 ， 只 需要 开发 者 在 Spring Security 的 配置 类 中 提供 一 个 
RoleHierarchy 即 可 ， 代 码 如 下 : 








1 @Bean 

区 RoleHierarchy roleHierarchy() { 

3 RoleHierarchyImpl] roleHierarchy = new RoleHierarchyImp1() 

4 String hierarchy = "ROLE dba > ROLE admin ROLE admin > ROLE user"; 
5 roleHierarchy.setHierarchy (hierarchy); 

6 return roleHierarchy; 

2 


} 











配置 完 RoleHierarchy 之 后 ， 具 有 ROLE dba 角色 的 用 户 就 可 以 访问 所 有 资源 了 ， 具 有 
ROLE admin 角色 的 用 户 也 可 以 访问 具有 ROLE user 角色 才能 访问 的 资源 。 
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10.3.2 ”动态 配置 权限 


使 用 HttpSecurity 配置 的 认证 授权 规则 还 是 不 够 灵活 ， 无 法 实现 资源 和 角色 之 间 的 动态 调整 ， 
要 实现 动态 配置 URL 权限 ， 就 需要 开发 者 自 定义 权限 配置 ， 配 置 步骤 如 下 《〈 本 案例 在 10.2 节 案 例 
的 基础 上 完成 ) 。 

1. 数据 库 设计 

这 里 的 数据 库 在 10.2 节 数据 库 的 基础 上 再 增加 一 张 资源 表 和 资源 角色 关联 表 , 如 图 10-8 所 示 。 
资源 表 中 定义 了 用 户 能 够 访问 的 URL 模式 , 资源 角色 表 则 定义 了 访问 该 模式 的 URL 需要 什么 样 的 
角色 。 























图 10-8 


2. 自 定义 FilterlnvocationSecurityMetadataSource 

要 实现 动态 配置 权限 ， 首 先 要 自 定义 FilterInvocationSecurityMetadataSource，Spring Security 
中 通过 FilterInvocationSecurityMetadataSource 接口 中 的 getAttributes 方法 来 确定 一 个 请 求 需要 哪些 
角 色 ， FilterInvocationSecurityMetadataSource 接口 的 默认 实现 类 是 
DefaultFilterInvocationSecurityMetadataSource ， 参 考 DefaultFilterInvocationSecurityMetadataSource 
的 实现 ， 开 发 者 可 以 定义 自己 的 FilterInvocationSecurityMetadataSource， 代 码 如 下 : 





1 QComponent 

2 public class CustomFilterInvocationSecurityMetadataSource 

3 implements FilterInvocationSecurityMetadataSource { 

4 AntPathMatcher antPathMatcher = new AntPathMatcher () 

5 QAutowired 

6 MenuMapper menuMapper; 

7 QOverride 

8 public Collection<ConfigAttribute> getAttributes (Object object) 
throws IllegalArgumentException { 

10 String requestUTr1 = ((FilterInvocation) object) .getRequestUrl (); 
11 List<Menu> allMenus = menuMapper.getAllMenus (); 

2 for (Menu menu : allMenus) { 
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| if (antPathMatcher.match (menu.getPattern(), requestUrl)) { 
14 List<Role> roles = menu.getRoles(); 

15 String[] roleArr = new String[roles.size()]; 

16 for (int i = 0; i < roleArr.length; i++) { 

17 roleArr[i] = roles.get (i) .getName(); 

18 } 

19 return SecurityConfig.createList (roleArr); 

20 } 

eq 

22 return SecurityConfig.createList ("ROLE LOGIN"); 

23 } 

24 QOverride 

25 public Collection<ConfigAttribute> getAllConfigAttributes() { 
26 return null; 

pl } 

28 QOverride 

29 public boolean supports (Class<?> clazz) { 

30 return FilterInvocation.class.isAssignableFrom(clazz); 

31 } 

32 | } 








代码 解释 : 


@ 开发 者 自 定义 FilterInvocationSecurityMetadataSource 主要 实现 该 接口 中 的 getAttributes 方法 ， 
该 方法 的 参数 是 一 个 FilterInvocation， 开 发 者 可 以 从 FilterInvocation 中 提取 出 当前 请 求 的 
URL， 返 回 值 是 Collection<ConfigAttribute>， 表 示 当 前 请 求 URL 所 需 的 角色 。 

日 第 4 行 创建 一 个 AntPathMatcher， 主 要 用 来 实现 ant 风格 的 URL 匹配。 

日 第 10 行 从 参数 中 提取 出 当前 请 求 的 URL。 

@ 第 11 行 从 数据 库 中 获取 所 有 的 资源 信息 ， 即 本 案例 中 的 menu 表 以 及 menu 所 对 应 的 role， 
在 真实 项 目 环境 中 ， 开 发 者 可 以 将 资源 信息 缓存 在 Redis 或 者 其 他 缓存 数据 库 中 。 

e 第 12~21 行 遍历 资源 信息 ， 遍 历 过 程 中 获取 当前 请 求 的 URL 所 需要 的 角色 信息 并 返回 。 如 
果 当 前 请 求 的 URL 在 资源 表 中 不 存在 相应 的 模式 , 就 假设 该 请 求 登录 后 即 可 访问 , 即 直接 返 
回 ROLE LOGIN. 

® ”getAllConfigAttributes 方法 用 来 返回 所 有 定义 好 的 权限 资源 ，Spring Security 在 启动 时 会 校 验 
相关 配置 是 否 正确 ， 如 果 不 需要 校 验 ， 那 么 该 方法 直接 返回 null 即 可 。 

@ ”supports 方法 返回 类 对 象 是 否 支持 校 验 。 





3. 自 定义 AccessDecisionManager 


当 一 个 请 求 走 完 FilterInvocationSecurityMetadataSource 中 的 getAttributes 方法 后 ， 接 下 来 就 会 
来 到 AccessDecisionManager 类 中 进行 角色 信息 的 比 对 ， 自 定义 AccessDecisionManager 如 下 : 





@Component 
public class CustomAccessDecisionManager implements AccessDecisionManager { 
QOverride 
public void decide (Authentication auth, 
Object object, 
Collection<ConfigAttribute> ca){ 


ao 必 wm 
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Collection<? extends GrantedRAuthority> auths = auth.getAuthorities(); 

8 for (ConfigAttribute configAttribute : ca) { 
if ("ROLE LOGIN".equals (configAttribute.getAttribute()) 

10 | gg auth instanceof UsernamePasswordAuthenticationToken) { 
11 return; 
12 
3 for (GrantedAuthority authority : auths) { 
14 if (configAttribute.getAttribute() .equals (authority.getAuthority ())) 
| 
16 return; 
17 , 
18 } 
19 } 
20 throw new AccessDeniedException ("权限 不 足 "); 
21 } 
22 
23 QOverride 
24 public boolean supports (ConfigAttribute attribute) { 
25 return true; 
26 } 
27 
28 QOverride 
29 public boolean supports (Class<?> clazz) { 
30 return true; 
31 } 











代码 解释 : 


@ 自 定义 AccessDecisionManager 并 重 写 decide 方法 ， 在 该 方法 中 判断 当前 登录 的 用 户 是 否 具 
备 当前 请 求 URL 所 需要 的 角色 信息 ， 如 果 不 具备 ， 就 抛 出 AccessDeniedException 异常 ， 否 
则 不 做 任何 事 即 可 。 

e@ decide 方法 有 三 个 参数 ， 第 一 个 参数 包含 当前 登录 用 户 的 信息 ; 第 二 个 参数 则 是 一 个 
FilterInvocation 对 象 ， 可 以 获取 当前 请 求 对 象 等 ; 第 三 个 参数 就 是 
FilterInvocationSecurityMetadataSource 中 的 getAttributes 方法 的 返回 值 ， 即 当前 请 求 URL 所 
需要 的 角色 。 

® 第 7~19 行进 行 角色 信息 对 比 ， 如 果 需 要 的 角色 是 ROLE LOGIN， 说 明 当 前 请 求 的 URL 用 
户 登 录 后 即 可 访问 ， 如 果 auth 是 UsemamePasswordAuthenticationToken 的 实例 ， 那 么 说 明 当 
前 用 户 已 登录 ， 该 方法 到 此 结束 ， 否 则 进入 正常 的 判断 流程 ， 如 果 当 前 用 户 具备 当前 请 求 需 
要 的 角色 ， 那 么 方法 结束 。 


当然 ， 本 案例 还 涉及 MenuMapper 和 MenuMapperxml， 实 现 如 下 : 


@Mapper 
public interface MenuMapper { 


List<Menu> getAllMenus (); 


} 
<!DOCTYPE mapper 
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6 PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 

7 "http://mybatis.org/dtd/mybatis-3-mapper.dtd"> 

8 <mapper namespace="org.sang.security02.mapper.MenuMapper"> 

9 <resultMap id="BaseResultMap" type="org.sang.security02.model.Menu"> 

10 | <id property="id" column="id"/> 

11 | <result property="pattern" column="pattern"/> 

12 | <collection property="roles" ofType="org.sang.security02.model.Role"> 

13 | <id property="id" column="rid"/> 

14 | <result property="name" column="rname"/> 

15 | <result property="nameZh" column="rnameZh"/> 

16 | </collection> 

17 | </resultMap> 

18 | <select id="getAllMenus" resultMap="BaseResultMap"> 

19 SELECT m.*,r.id RS rid,r.name RS rname,r.nameZh AS rnameZh FROM menu m LEFT 
20 | JOIN menu role mr ON m.‘id‘=mr. mid” LEFT JOIN role r ON mr.‘rid‘=r.‘id. 
21 | </select> 

22 | </mapper> 





口 虽 ammwm 














4. 配置 
最 后 ， 在 Spring Security 中 配置 如 上 两 个 自 定义 类 ， 部 分 源码 如 下 : 


@Configuration 
public class WebSecurityConfig extends WebSecurityConfigurerAdapter { 
QOverride 
protected void configure (HttpSecurity http) throws Exception { 
http.authorizeRequests () 
.withObjectPostProcessor (new 
ObjectPostProcessor<FilterSecurityInterceptor>() { 
QOverride 
public <O extends FilterSecurityInterceptor> 0 postProcess (0 object) { 
object .setSecurityMetadataSource (cfisms ()); 
object .setAccessDecisionManager (cadm()); 
return object; 


} 
-and() 
.formLogin() 
.loginProcessingUr]l ("/login") .permitAll () 
-and() 
.Csrf() .disable (); 
} 
QBean 
CustomFilterInvocationSecurityMetadataSource cfisms() { 
return new CustomFilterInvocationSecurityMetadataSource (); 
} 
QBean 
CustomAccessDecisionManager cadm() { 
return new CustomAccessDecisionManager (); 
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代码 解释 : 

日 本 案例 WebSecurityConfig 类 的 定义 是 对 10.2 节 中 WebSecurityConfig 定义 的 补充 ， 主 要 是 修 
改 了 configure(HttpSecurity http) 方 法 的 实现 并 添加 了 两 个 Bean。 

e 第 9、10 行 ， 在 定义 FilterSecurityInterceptor 时 ， 将 我 们 自 定义 的 两 个 实例 设置 进去 即 可 。 


经 过 上 面 的 配置 , 我 们 已 经 实现 了 动态 配置 权限 , 权限 和 资源 的 关系 可 以 在 menu role 表 中 动 
态 调整 。 测 试 案例 可 以 参考 10.1 节 的 测试 案例 ， 这 里 不 再 袭 述 。 


10.4 OAuth 2 


10.4.1 OAuth 2 简介 


OAuth 是 一 个 开放 标准 ， 该 标准 允许 用 户 让 第 三 方 应 用 访问 该 用 户 在 某 一 网 站 上 存储 的 私密 
资源 (如 头像 、 照 片 、 视 频 等 ) ， 而 在 这 个 过 程 中 无 须 将 用 户 名 和 密码 提供 给 第 三 方 应 用 。 实 现 这 
一 功能 是 通过 提供 一 个 令 牌 〈token) ， 而 不 是 用 户 名 和 密码 来 访问 他 们 存放 在 特定 服务 提供 者 的 
数据 。 每 一 个 令 牌 授权 一 个 特定 的 网 站 在 特定 的 时 段 内 访问 特定 的 资源 。 这 样 ，OAuth 让 用 户 可 以 
授权 第 三 方 网 站 灵活 地 访问 存储 在 另外 一 些 资源 服务 器 的 特定 信息 ， 而 非 所 有 内 容 。 例 如 ,用 户 想 
通过 QQ 登录 知 乎 ， 这 时 知 乎 就 是 一 个 第 三 方 应 用 ,， 知 乎 要 访问 用 户 的 一 些 基本 信息 就 需要 得 到 用 
户 的 授权 ， 如 果 用 户 把 自己 的 QQ 用 户 名 和 密码 告诉 知 乎 ， 那么 知 乎 就 能 访问 用 户 的 所 有 数据 ， 并 
且 只 有 用 户 修改 密码 才能 收回 授权 ,这 种 授权 方式 安全 隐患 很 大 ， 如 果 使 用 OAuth, 就 能 很 好 地 解 
决 这 一 问题 。 

采用 令 牌 的 方式 可 以 让 用 户 灵活 地 对 第 三 方 应 用 授权 或 者 收回 权限 。OAuth 2 是 OAuth 协议 
的 下 一 版 本 ， 但 不 向 下 兼容 OAuth 1.0。OAuth 2 关注 客户 端 开发 者 的 简易 性 ， 同 时 为 Web 应 用 、 
桌面 应 用 、 移 动 设备 、 起 居室 设备 提供 专门 的 认证 流程 。 传 统 的 Web 开发 登录 认证 一 般 都 是 基于 
Session 的 , 但 是 在 前 后 端 分 离 的 架构 中 继续 使 用 Session 会 有 许多 不 便 , 因为 移动 端 (Android、iOS、 
微 信 小 程序 等 ) 要 么 不 支持 Cookie( 微 信 小 程序 ), 要 么 使 用 非常 不 便 , 对 于 这 些 问题 , 使 用 OAuth 2 
认证 都 能 解决 。 





10.4.2 OAuth 2 角色 


要 了 解 OAuth 2， 需 要 先 了 解 OAuth 2 中 几 个 基本 的 角色 。 

日 资源 所 有 者 : 资源 所 有 者 即 用 户 ， 具 有 头像 、 照 片 、 视 频 等 资源 。 

e@ 客户 端 : 客户 端 即 第 三 方 应 用 ， 例 如 上 文 提 到 的 知 乎 。 

@ ”授权 服务 器 : 授权 服务 器 用 来 验证 用 户 提供 的 信息 是 否 正确 , 并 返回 一 个 令 牌 给 第 三 方 应 用 。 
日 资源 服务 器 : 资源 服务 器 是 提供 给 用 户 资源 的 服务 器 ， 例 如 头像 、 照 片 、 视 频 等 。 


一 般 来 说 ， 授 权 服务 器 和 资源 服务 器 可 以 是 同一 台 服 务 器 。 
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10.4.3 ”OAuth 2 授权 流程 


OAuth 2 的 授权 流程 到 底 是 什么 样 的 呢 ? 如 图 10-9 所 示 。 

这 是 OAuth 2 一 个 大 致 的 授权 流程 图 ， 有 具体 步骤 如 下 : 

步骤 014 客户 端 ( 第 三 方 应 用 ) 向 用 户 请 求 授权 。 

步 又 024 用 户 单 击 客户 端 所 呈现 的 服务 授权 页 面 上 的 同意 授权 按钮 后 ， 服 务 端 返回 一 个 授权 
许可 凭证 给 客户 端 。 

步骤 034 客户 端 拿 着 授权 许可 凭证 去 授权 服务 器 申请 令 牌 。 

步骤 044 授权 服务 器 验证 信息 无 误 后 ， 发 放 令 牌 给 客户 端 。 

步 最 054 客户 端 拿 着 令 牌 去 资源 服务 器 访问 资源 。 

步骤 064 资源 服务 器 验证 令 牌 无 误 后 开放 资源 。 


这 是 一 个 大 致 的 流程 ， 因 为 OAuth 2 中 有 4 种 不 同 的 授权 模式 ， 每 种 授权 模式 的 授权 流程 又 
会 有 差异 ， 基 本 流程 如 图 10-9 所 示 。 















































图 10-9 


10.4.4 授权 模式 


OAuth 协议 的 授权 模式 共 分 为 4 种 ， 分 别 说 明 如 下 。 

@ 授权 码 模式 : 授权 码 模式 (authorization code ) 是 功能 最 完整 、 流 程 最 严谨 的 授权 模式 . 它 的 
特点 就 是 通过 客户 端的 服务 器 与 授权 服务 器 进行 交互 ， 国 内 常见 的 第 三 方 平台 登录 功能 基本 
都 是 使 用 这 种 模式 。 

日 ”简化 模式 : 简化 模式 不 需要 客户 端 服务 器 参与 ， 直 接 在 浏览 器 中 向 授权 服务 器 申请 令 牌 ， 一 
般若 网 站 是 纯 静 态 页 面 ， 则 可 以 采用 这 种 方式 。 

日 ”密码 模式 : 密码 模式 是 用 户 把 用 户 名 密码 直接 告诉 客户 端 ， 客 户 端 使 用 这 些 信息 向 授权 服务 
器 申请 令 牌 。 这 需要 用 户 对 客户 端 高 度 信任 ， 例 如 客户 端 应 用 和 服务 提供 商 是 同一 家 公司 。 
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日 客户 端 模式 : 客户 端 模式 是 指 客户 端 使 用 自己 的 名 义 而 不 是 用 户 的 名 义 向 服务 提供 者 申请 授 
权 。 严 格 来 说 ， 客 户 端 模式 并 不 能 算 作 OAuth 协议 要 解决 的 问题 的 一 种 解决 方案 ， 但 是 ， 对 
于 开发 者 而 言 ， 在 一 些 前 后 端 分 离 应 用 或 者 为 移动 端 提供 的 认证 授权 服务 器 上 使 用 这 种 模式 
还 是 非常 方便 的 。 


这 4 种 模式 各 有 千秋 ， 分 别 适用 于 不 同 的 开发 场景 ， 开 发 者 要 根据 实际 情况 进行 选择 。 


10.4.5 ”实践 


本 案例 要 介绍 的 是 在 前 后 端 分 离 应 用 (或 者 为 移动 端 、 微 信 小 程序 等 提供 的 认证 服务 器 中 
如 何 搭建 OAuth 服务 ， 因 此 主要 介绍 密码 模式 。 搭 建 步骤 如 下 。 


1. 创建 项 目 ， 添 加 依赖 
创建 Spring Boot Web 项 目 ， 添 加 如 下 依赖 : 


<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-security</artifactId> 
</dependency> 

<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-data-redis</artifactId> 
<exclusions> 

9 | <exclusion> 

10 | <groupId>io.lettuce</groupId> 

11 | <artifactId>lettuce-core</artifactId> 

12 | </exclusion> 

13 | </exclusions> 

14 | </dependency> 

15 | <dependency> 

16 | <groupId>redis.clients</groupId> 

17 | <artifactId>jedis</artifactId> 

18 | </dependency> 

19 | <dependency> 

20 | <groupId>org.springframework.boot</groupId> 

21 | <artifactId>spring-boot-starter-web</artifactId> 

22 | </dependency> 

23 | <dependency> 

24 | <groupId>org.springframework.security.oauth</groupId> 
25 | <artifactId>spring-security-oauth2</artifactId> 

26 | <version>2.3.3.RELEASE</version> 

27 | </dependency> 


由 于 Spring Boot 中 的 OAuth 协议 是 在 Spring Security 的 基础 上 完成 的 , 因此 首先 要 添加 Spring 
Security 依赖 ， 要 用 到 OAuth 2， 因 此 添加 OAuth 2 相关 依赖 ， 令 牌 可 以 存储 在 Redis 缓存 服务 器 
上 ， 同 时 Redis 具有 过 期 等 功能 ， 很 适合 令 牌 的 存储 ， 因 此 也 加 入 Redis 依赖 。 

项 目 创建 成 功 后 ， 接 下 来 在 application.properties 中 配置 一 下 Redis 服务 器 的 连接 信息 ， 代 码 








camm 必 wm 
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cmewm 


spring. 
spring. 
spring. 
spring. 
spring. 
spring. 
spring. 
spring. 


redis. 
redis. 
redis. 


redis 


redis 


redis 


database=0 


host=192.168.66.129 


port=6379 


jedis.pool. 


.jedis.pool. 
redis. 


jedis.pool. 


.jedis.pool. 


.password=123@456 
redis. 


max-active=8 
max-idle=8 
max-wait=-lms 
min-idle=0 





oop 





Redis 配置 可 以 参考 6.1 节 ， 这 里 不 再 袭 述 。 
2. 配置 授权 服务 器 


授权 服务 器 和 资源 服务 器 可 以 是 同一 台 服务 器 ， 也 可 以 是 不 同 服务 器 ， 本 案例 中 假设 是 同一 
台 服 务 器 ， 通 过 不 同 的 配置 分 别 开 启 授权 服务 器 和 资源 服务 器 ， 首 先是 授权 服务 器 : 


@Configuration 
@EnableAuthorizationServer 








public class AuthorizationServerConfig 


extends AuthorizationServerConfigurerAdapter { 
@Autowired 
AuthenticationManager authenticationManager; 
@Autowired 
RedisConnectionFactory redisConnectionFactory; 
@Autowired 
UserDetailsService userDetailsService; 
QBean 
PasswordEncoder passwordEncoder() { 
return new BCryptPasswordEncoder (); 
} 
QOverride 
public void configure (ClientDetailsServiceConfigurer clients) 
throws Exception { 
clients.inMemory () 
.withClient ("password") 
.authorizedGrantTYpes ("password", "refresh token" 
.accessTokenValiditySeconds (1800) 
.resourcelIds ("rid" 
.scopes ("all") 
.Secret ("$2a$10$RMuFXGQSAtHAwOvkUqyvuecpqUSeoxZYqilXzbz50dceRsga.WYiq"); 
} 
QOverride 
public void configure (AuthorizationServerEndpointsConfigurer endpoints) 
throws Exception { 
endpoints .tokenStore (new RedisTokenStore (redisConnectionFactory) 
.authenticationManager (authenticationManager) 
.userDetailsService (userDetailsService); 
} 


QOverride 
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34 public void configure (AuthorizationServerSecurityConfigurer security) 
35 throws Exception { 
36 security.allowFormAuthenticationForClients (); 
Ey } 
38 | } 
代码 解释 : 
日 自 定义 类 继承 自 AuthorizationServerConfigurerAdapter， 完 成 对 授权 服务 器 的 配置 ， 然 后 通过 
@EnableAuthorizationServer 注解 开启 授权 服务 器 。 
@ 第 5、6 行 注入 了 AuthenticationManager， 该 对 象 将 用 来 支持 password 模式 。 
e 第 7、8 行 注入 了 RedisConnectionFactory， 该 对 象 将 用 来 完成 Redis 缓存 ， 将 令 牌 信息 存储 到 
Redis 缓存 中 。 

@ 第 9、10 行 注入 了 UserDetailsService， 该 对 象 将 为 刷新 token 提供 支持 。 

@ 第 11~14 行 提供 一 个 PasswordEncoder， 这 个 和 前 文中 的 配置 一 样 ， 不 再 次 述 。 

@ 第 19~24 行 配置 password 授权 模式 ，authorizedGrantTypes 表示 OAuth 2 中 的 授权 模式 为 
“password” 和 “refresh token” 两 种 ， 在 标准 的 OAuth 2 协议 中 ， 授 权 模 式 并 不 包括 
“Tefresh_token”, 但 是 在 Spring Security 的 实现 中 将 其 归 为 一 种 , 因此 如 果 要 实现 access_token 

的 刷新 , 就 需要 添加 这 样 一 种 授权 模式 ; accessTokenValiditySeconds 方法 配置 了 access_token 
的 过 期 时 间 ; resourcelds 配置 了 资源 id; secret 方法 配置 了 加 密 后 的 密码 ， 明 文 是 123。 

e@ 第 29 行 配置 了 令 牌 的 存储 ，AuthenticationManager 和 UserDetailsService 主要 用 于 支持 

password 模式 以 及 令 牌 的 刷新 。 

@ 第 36 行 的 配置 表示 支持 client id 和 client secret 做 登录 认证 。 

3. 配置 资源 服务 器 

接 下 来 配置 资源 服务 器 ， 代 码 如 下 : 

1 @Configuration 

2 @EnableResourceServer 

3 public class ResourceServerConfig extends ResourceServerConfigurerAdapter { 
4 QOverride 

5 public void configure (ResourceServerSecurityConfigurer resources) 
6 throws Exception { 

有 Tesources .resourceId("rid") .stateless (true); 

8 } 

9 QOverride 

10 public void configure (HttpSecurity http) throws Exception { 

和 和 http .authorizeRequests () 

12 .antMatchers("/admin/**") .hasRole ("admin") 

13 -antMatchers ("/user/**") .hasRole ("user") 

14 .anyRequest () .authenticated(); 








代码 解释 : 


自 定义 类 继承 自 ResourceServerConfigurerAdapter, 并 添加 (@EnableResourceServer 注解 开启 资 
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源 服务 器 配置 。 
e 第 7 行 配置 资源 id， 这 里 的 资源 id 和 授权 服务 器 中 的 资源 id 一 致 ， 然 后 设置 这 些 资源 仅 基 
于 令 牌 认证 。 
e 第 11~14 行 配置 HttpSecurity， 这 和 10.1 节 介 绍 的 配置 一 致 ， 不 再 痪 述 。 
4. 配置 Security 
接 下 来 配置 Spring Security， 代 码 如 下 : 
时 Q@Configuration 
2 public class WebSecurityConfig extends WebSecurityConfigurerAdapter { 
3 QBean 
4 QOverride 
5 public AuthenticationManager authenticationManagerBean() throws Exception { 
6 return super.authenticationManagerBean (); 
于 } 
8 Q@Bean 
9 Q@Override 
0 protected UserDetailsService userDetailsService() { 
1 return super.userDetailsService(); 
2 } 
3 QOverride 
4 protected void configure (AuthenticationManagerBuilder auth) throws Exception { 
5 auth.inMemoryAuthentication() 
6 .withUser ("admin") 
3 .password ("$2a$10$RMuFXGQS5AtHAwOvkUqyvuecpqUSeoxZYqilXzbz50dceRsga.WYiq") 
8 .roles ("admin") 
9 .and() 
20 .withUser ("sang") 
> .password ("$2a$10$RMuFXGQS5AtHAwOvkUqyvuecpqUSeoxZYqilXzbz50dceRsga.WYiq") 
22 .TOoles ("user"); 
23 
24 Override 
25 protected void configure (HttpSecurity http) throws Exception { 
26 http .antMatcher ("/oauth/**") .authorizeRequests () 
27 .antMatchers ("/oauth/**") .permitAll () 
28 .and() .csrf() .disable(); 
29 } 
30 | } 





这 是 











县 Spring Security 的 配置 基本 上 和 前 文 一 致 ， 唯 一 不 同 的 是 多 了 两 个 Bean， 这 里 两 个 Bean 
将 注入 授权 服务 器 配置 类 中 使 用 。 另 外 ， 这 里 的 HttpSecurity 配置 主要 是 配置 “/oauth/** ”模式 的 
URL， 这 一 类 的 请 求 直接 放行 。 在 Spring Security 配置 和 资源 服务 器 配置 中 ， 一 共 涉 及 两 个 
HttpSecurity， 其 中 Spring Security 中 的 配置 优先 级 高 于 资源 服务 器 中 的 配置 ， 即 请 求 地 址 先 经 过 
Spring Security 的 HttpSecurity， 再 经 过 资源 服务 器 的 HttpSecurity。 


5. 测试 验证 





首先 创建 三 个 简单 的 请 求 地 址 ， 代 码 如 下 : 
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1 @RestController 

当 public class HelloController { 
@GetMapping ("/admin/hello") 
4 public string admin() { 

入 return "Hello admin!"; 
6 } 

六 @GetMapping ("/user/hello") 
8 public string user() { 

9 return "Hello user!"; 
10 二 

11 Q@GetMapping ("/hello") 

12 public String hello() { 

13 return "hello"; 

14 } 

15 








根据 前 文 的 配置 ， 要 请 求 这 三 个 地 址 ， 分 别 需 要 admin 角色 、user 角色 以 及 登录 后 访问 。 

所 有 都 配置 完成 后 ， 启 动 Redis 服务 器 ， 再 启动 Spring Boot 项 目 ， 首 先 发 送 一 个 POST 请 求 
获取 token， 请 求 地 址 如 下 (注意 这 里 是 一 个 POST 请 求 ， 为 了 显示 方便 ， 将 参数 写 在 地 址 栏 中 ) : 

http://localhost:8080/0auth/token?usermmame=sang&password=123&grant type=password&client id 


=password&scope=all&client_secret=123 
请 求 地 址 中 包含 的 参数 有 用 户 名 、 密 码 、 授 权 模式 、 客 户 端 id、scope 以 及 客户 端 密 码 ， 基 本 
就 是 授权 服务 器 中 所 配置 的 数据 ， 请 求 结果 如 图 10-10 所 示 。 
"access_token": "918f7927-6144-4b47-ac5e-df7ee6a93fb6"， 


"token_type": “bearer"， 
"refresh_token": "3369335cd-alal-44b7-8d9d-1c531dd6e82e"， 


"expires_in": 1799, 
"scope”: "all” 





图 10-10 


返回 结果 有 access_token、token type、refresh_token、expires_in 以 及 scope， 其 中 access_token 
是 获取 其 他 资源 时 要 用 的 令 牌 ，refresh token 用 来 刷新 令 牌 ，expires_in 表示 access_token 的 过 期 时 
间 ， 当 access_token 过 期 后 ， 使 用 refresh token 重新 获取 新 的 access_token (前 提 是 refresh token 
未 过 期 ) ， 请 求 地 址 如 下 注意 这 里 也 是 POST 请 求 ) : 

http://localhost:8080/0auth/token?grant_type=refresh token&refresh token=6b80de74-e264-4ca5-b 
9cc-20e8a6fa486d&client id=password&client_ secret=123 

获取 新 的 access_token 时 需要 携带 上 refresh token， 同 时 授权 模式 设置 为 refresh token， 在 获 
取 的 结果 中 access_token 会 变化 ， 同 时 access_token 有 效 期 也 会 变化 ， 如 图 10-11 所 示 。 





"access_token": 


"136ea275-ae18-4b36-8bfd-9b4963bb11af"， 





"token_ type": "bearer", 
"refresh_token": "338335cd-alal-44b7-8d9d-1c531dd9e82e", 
"expires_in": 1799, 





"scope": " 





图 10-11 


194 | Spring Boot+Vue 全 栈 开发 实战 





接 下 来 访问 所 有 资源 ， 携 带 上 access_token 参数 即 可 ， 例 如 “muserhello” 接 口 : 
http://localhost:8080/user/hello?access token=136ea275-ael8-4b36-8bfd-0b4963bb] 1af 
访问 结果 如 图 10-12 所 示 。 








GET ~ herp:/localhosc8080/user/hellozaccess roken=136ea275-ae18-4b36-8bfd-0b4963bb11af 








Hel1lol user! 





图 10-12 





如 果 非 法 访问 一 个 资源 ， 例 如 sang 用 户 访问 “/admin/hello” 接 口 ， 结 果 如 图 10-13 所 示 。 








图 10-13 


最 后 ， 再 来 看 一 下 Redis 中 的 数据 ， 如 图 10-14 所 示 。 





图 10-14 


到 此 ， 一 个 password 模式 的 OAuth 认证 体系 就 搭建 成 功 了 。 
OAuth 中 的 认证 模式 有 4 种 ， 读 者 需要 结合 自己 开发 的 实际 情况 选择 其 中 一 种 ， 本 案例 介绍 
的 是 在 前 后 端 分 离 应 用 中 常用 的 password 模式 ， 其 他 的 授权 模式 也 都 有 自己 的 使 用 场景 。 
整体 来 说 ，Spring Security OAuth 2 的 使 用 还 是 较 复 杂 的 ， 配 置 也 比较 烦琐 ， 如 果 开 发 者 的 应 
场景 比较 简单 ， 完 全 可 以 按照 前 文 介绍 的 授权 流程 自己 搭建 OAuth 2 认证 体系 。 
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10.5 _ Spring Boot 整合 Shiro 


10.5.1 Shiro 简介 


Apache Shiro 是 一 个 开源 的 轻 量 级 的 Java 安全 框架 ， 它 提供 身份 验证 、 授 权 、 密 码 管理 以 及 








会 话 管理 等 功能 。 相 对 于 Spring Security, Shiro 框架 更 加 直观 、 易 用 , 同时 也 能 提供 健壮 的 安全 性 。 
在 传统 的 SSM 框架 中 ， 手 动 整合 Shiro 的 配置 步骤 还 是 比较 多 的 ， 针 对 Spring Boot，Shiro 官方 提 
供 了 shiro-spring-boot-web-starter 用 来 简化 Shiro 在 Spring Boot 中 的 配置 。 下 面向 读者 介绍 
shiro-spring-boot-web-starter 的 使 用 步骤 。 


10.5.2 整合 Shiro 


口 虽 ammwm 


上 卢 
Po 


记忆 
wD 





> 
心 


1. 创建 项 目 
首先 创建 一 个 普通 的 Spring Boot Web 项 目 ， 添 加 Shiro 依赖 以 及 页 面 模板 依赖 ， 代 码 如 下 : 


<dependency> 

<groupId>org.apache.shiro</groupId> 
<artifactId>shiro-spring-boot-web-starter</artifactId> 
<version>1.4.0</version> 

</dependency> 

<dependency> 

<groupId>org. springframework.boot</groupId> 
<artifactId>spring-boot-starter-thymeleaf</artifactId> 
</dependency> 

<dependency> 
<groupId>com.github.theborakompanioni</groupId> 
<artifactId>thymeleaf-extras-shiro</artifactId> 
<version>2.0.0</version> 

</dependency> 











注意 这 里 不 需要 添加 spring-boot-starter-web 依赖 ，shiro-spring-boot-web-starter 中 已 经 依赖 了 


spring-boot-starter-web。 同 时 ， 本 案例 使 用 Thymeleaf 模板 ， 因 此 添加 Thymeleaf 依赖 ， 另 外 ， 为 
了 在 Thymeleaf 中 使 用 shiro 标签 ， 因 此 引入 了 thymeleaf-extras-shiro 依赖 。 


2. Shiro 基本 配置 
首先 在 application.properties 中 配置 Shiro 的 基本 信息 ， 代 码 如 下 : 








om wm 


shiro.enabled=true 

shiro.web.enabled=true 

shiro.loginUrl=/login 

shiro.successUrl=/index 
shiro.unauthorizedUrl=/unauthorized 
shiro.sessionManager.sessionIdUrlRewritingEnabled=true 
shiro.sessionManager.sessionIdCookieEnabled=true 
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代码 解释 : 


第 1 行 配置 表示 开启 Shiro 配置 ， 默 认为 tue。 

第 2 行 配置 表示 开启 Shiro Web 配置 ， 默 认为 true。 

第 3 行 配置 表示 登录 地 址 ， 默 认为 “/loingjsp”。 

第 4 行 配置 表示 登录 成 功 地 址 ， 默 认为 “/”。 

第 5 行 配置 表示 未 获 授权 默认 跳 转 地 址 。 

第 6 行 配置 表示 是 否 允 许 通过 URL 参数 实现 会 话 跟踪 ， 如 果 网 站 支持 Cookie， 可 以 关闭 此 
选项 ， 默 认为 true。 

第 7 行 配置 表示 是 否 允 许 通过 Cookie 实现 会 话 跟踪 ， 默 认为 true。 


基本 信息 配置 完成 后 ， 接 下 来 在 Java 代码 中 配置 Shiro， 提 供 两 个 最 基本 的 Bean 即 可 ， 代 码 

















如 下 : 
人 @Configuration 
2 | public class ShiroConfig { 
号 QBean 
4 public Realm realm() { 
5 TextConfigurationRealm realm = new TextConfigurationRealm(); 
6 realm.setUserDefinitions ("sang=123, user\n admin=123,admin"); 
本 realm.setRoleDefinitions ("admin=read, write\n user=read"); 
8 return realm; 
9 } 
0 QBean 
家 public ShiroFilterChainDefinition shiroFilterChainDefinition() { 
2 DefaultShiroFilterChainDefinition chainDefinition = 
3 new DefaultShiroFilterChainDefinition(); 
4 chainDefinition.addPathDefinition("/login", "anon"); 
号 chainDefinition.addPathDefinition("/doLogin", "anon"); 
6 chainDefinition.addPathDefinition("/logout", "logout"); 
2 chainDefinition.addPathDefinition("/**", "authc"); 
8 return chainDefinition; 
9 } 
20 QBean 
21 public ShiroDialect shiroDialect() { 
2 return new ShiroDialect(); 
23 } 
24 
代码 解释 : 


@ 这 里 提供 两 个 关键 Bean, 一 个 是 Realm, 另 一 个 是 ShiroFilterChainDefinition。 至 于 ShiroDialect， 


则 是 为 了 支持 在 Thymeleaf 中 使 用 Shiro 标签 ， 如 果 不 在 Thymeleaf 中 使 用 Shiro 标签 ， 那 么 
可 以 不 提供 ShiroDialect。 

Realm 可 以 是 自 定义 Realm， 也 可 以 是 Shiro 提供 的 Realm， 简 单 起 见 ， 本 案例 没有 配置 数据 
库 连 接 , 这 里 直接 配置 了 两 个 用 户 : sang/123 和 admin/123, 分 别 对 应 角色 user 和 admin，user 
有 具有 read 权限 ，admin 则 具有 read、write 权限 。 
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e ShiroFilterChainDefinition Bean 中 配置 了 基本 的 过 小 规则 ，“/login” 和 “/doLogin” 可 以 匿名 
访问 ，“/logout” 是 一 个 注销 登录 请 求 ， 其 余 请 求 则 都 需要 认证 后 才能 访问 。 


接 下 来 配置 登录 接口 以 及 页 面 访问 接口 ， 代 码 如 下 : 


@Controller 
public class UserController { 
QPostMapping ("/doLogin") 
public String doLogin(String username, String password, Model model) { 





UsernamePasswordToken token = 
new UsernamePasswordToken (username, password); 
Subject subject = SecurityUtils.getSubject(); 
try { 
subject .login (token); 
} catch (AuthenticationException e) { 
model.addAttribute ("error"，" 用 户 名 或 密码 输入 错误 !") ; 


return "login"; 


cammwmn 


站 
return "redirect:/index"; 
} 
@RequiresRoles ("admin") 
@GetMapping ("/admin") 
public String admin() { 
return "admin"; 





oa i Po 


D 
S 


} 
Q@RequiresRoles (value = {"admin","user"},1ogical = Logical .OR) 
@GetMapping ("/user") 
public String user() { 
return "user"; 


FD N N ND 
mw 


} 








MD 
CN 





代码 解释 : 


@ 在 doLogin 方 法 中 ,首先 构造 一 个 UsemamePasswordToken 实例 ， 然 后 获取 一 个 Subject 对 象 
并 调用 该 对 象 中 的 login 方法 执行 登录 操作 ， 在 登录 操作 执行 过 程 中 ， 当 有 异常 抛 出 时 ， 说 
明 登 录 失败 ， 携 带 错误 信息 返回 登录 视图 ; 当 登 录 成 功 时 ， 则 重 定向 到 “/index”。 

日 接 下 来 暴露 两 个 接口 “admin” 和 “user"， 对 于 “/admin” 接 口 ， 需 要 具有 admin 角色 才 可 
以 访问 ; 对 于 “/user” 接 口 ， 具 备 admin 角色 和 user 角色 其 中 任意 一 个 即 可 访问 。 


对 于 其 他 不 需要 角色 就 能 访问 的 接口 ， 直 接 在 WebMvc 中 配置 即 可 ， 代 码 如 下 : 





1 | @Configuration 

2 | public class WebMvcConfig implements WebMvcConfigurer{ 

3 @Override 

4 public void addViewControllers (ViewControllerRegistry registry) { 

5 registry.addViewController ("/login") .setViewName ("login"); 

6 registry.addViewController ("/index") .setViewName ("index"); 

党 registry.addViewController ("/unauthorized") .setViewName ("unauthorized"); 
8 











198 | Spring Boot+Vue 全 栈 开发 实战 








9 | 





接 下 来 创建 全 局 异常 处 理 器 进行 全 局 异常 处 理 ， 本 案例 主要 是 处 理 授权 异常 ， 代 码 如 下 : 





Q@ControllerAdvice 
public class ExceptionController { 
@ExceptionHandler (AuthorizationException.class) 
public ModelAndView error (AuthorizationException e) { 
ModelAndView mv = new ModelAndView ("unauthorized"); 
mv.addobject ("error", e.getMessage()); 
return mv; 








co 站 局 mw 


} 


当 用 户 访问 未 授权 的 资源 时 ， 跳 转 到 unauthorized 视图 中 ， 并 携带 出 错 信息 。 
配置 完成 后 ， 最 后 在 resources/templates 日 录 下 创建 5 个 HTML 页 面 进行 测试 。 
(1) index.html， 代 码 如 下 : 


<!DOCTYPE html> 

<html lang="en" xmlns:shiro="http://www.pollix.at/thymeleaf/shiro"> 
<head> 

<meta charset="UTF-8"> 

<title>Title</title> 

</head> 

<body> 

<h3>Hello, <shiro:principal/></h3> 

<h3><a href="/1ogout"> 注 销 登录 </a></h3> 

<h3><a shiro:hasRole="admin" href="/admin"> 管 理 员 页 面 </a></h3> 
<h3><a shiro:hasAnyRoles="admin,user"” href="/user"> 普 通用 户 页 面 </a></h3> 
</body> 

</html> 


index.html 是 登录 成 功 后 的 首页 , 首先 展示 当前 登录 用 户 的 用 户 名 , 然后 展示 一 个 “注销 登录 ” 
链接 , 若 当 前 登录 用 户 具 备 “admin” 角 色 , 则 展示 一 个 “管理 员 页 面 ” 的 超 链接 ; 车 用 户 具备 “admin” 
或 者 “user” 角 色 ， 则 展示 一 个 “普通 用 户 页 面 ” 的 超 链接 。 注 意 这 里 导入 的 名 称 空间 是 
xmlns:shiro=http://www.pollix.at/thymeleaf/shiro， 和 JSP 中 导入 的 Shiro 名 称 空间 不 一 致 。 

(2) login.html， 代 码 如 下 : 





FFPocDmnamummwm 
Po 


上 
DS 











上 
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<!DOCTYPE html> 

<html lang="en" xmlns:th="http://www.thymeleaf.org"> 
<head> 

<meta charset="UTF-8"> 

<title>Title</title> 

</head> 

<body> 

<div> 

<form action="/doLogin" method="post"> 


oOoODp 


10 | <input type="text" name="username"><br> 
11 | <input type="password" name="password"><br> 
12 | <div th:text="$ {error}"></div> 
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13 
14 
15 
16 
17 


<input type="submit" value=" 登 录 "> 
</form> 

</div> 

</body> 

</html> 








login.html 是 一 个 普通 的 登录 页 面 ， 在 登录 失败 时 通过 一 个 div 显示 登录 失败 信息 。 
(3) userhtml， 代 码 如 下 : 











OCODp 


» 
oo 








<!DOCTYPE html> 

<html lang="en"> 
<head> 

<meta charset="UTF-8"> 


<title>Title</title> 
</head> 

<body> 

<h1> 普 通用 户 页 面 </h1> 
</body> 

</html> 





user.html 是 一 个 普通 的 用 户 信息 展示 页 面 。 
(4) admin.html， 代 码 如 下 : 











于 <!DOCTYPE html> 
2 <html lang="en"> 
EE <head> 
4 <meta charset="UTF-8"> 
5 | <title>Title</title> 
6 | </head> 
村 <body> 
8 | <h1> 管 理 员 页 面 </h1> 
9 | </body> 
10 | </html> 
admin.html 是 一 个 普通 的 管理 员 信 息 展示 页 面 。 
(5) unauthorized.html， 代 码 如 下 : 
¥ <!DOCTYPE html> 
2 <html lang="en" xmlns:th="http://www.thymeleaf.org"> 
3 <head> 
4 <meta charset="UTF-8"> 
5 <title>Title</title> 
6 |</head> 
时 <body> 
8 <div> 
9 | <h3> 未 获 授权 ， 非 法 访问 </h3> 
10 | <h3 th:text="${error}"></h3> 
11 | </div> 
12 | </body> 
13 | </html> 
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unauthorized html 是 一 个 授权 失败 的 展示 页 面 ， 该 页 面 还 会 展示 授权 出 错 的 信息 。 
3. 测试 


配置 完成 后 ， 启 动 Spring Boot 项 目 ， 访 问 登 录 页 面 ， 分 别 使 用 sang/123 和 admin/123 登录 ， 
结果 如 图 10-15、 图 10-16 所 示 。 注 意 ， 因 为 sang 用 户 不 具备 admin 角色， 因此 登录 成 功 后 的 页 面 
上 没有 前 往 管理 员 页 面 的 超 链接 。 


J ef Te x 二 








到 CO | © localhost:8080/index 


C OO | 9 localhost:8080/index 


Hello, admin 
Hello, sang 


注销 登录 
普通 用 户 页 面 
图 10-15 图 10-16 





登录 成 功 后 ， 无 论 是 sang 还 是 admin 用 户 ， 单 击 “ 注 销 登录 ”都 会 注销 成 功 ， 然 后 回 到 登录 
页 面 ，sang 用 户 因为 不 具备 admin 角色 ， 因 此 没有 “管理 员 页 面 ”的 超 链接 ， 无 法 进入 管理 员 页 
面 中 ， 此 时 ， 若 用 户 使 用 sang 用 户 登录 ， 然 后 手动 在 地 址 栏 输入 http://localhost:8080/admin， 则 会 
跳 转 到 未 授权 页 面 ， 如 图 10-17 所 示 。 


ae x 
C OO |© Ilocalhost8080/admir 


未 获 授权 ， 非 法 访问 


Subject does not have role [admin] 





图 10-17 


以 上 通过 一 个 简单 的 案例 向 读者 展示 了 如 何在 Spring Boot 中 整合 Shiro 以 及 如 何在 Thymeleaf 
中 使 用 Shiro 标签 ,一 旦 整合 成 功 , 接 下 来 Shiro 的 用 法 就 和 原来 的 一 模 一 样 。 本 小 节 主要 介绍 Spring 
Boot 整合 Shiro， 对 于 Shiro 的 其 他 用 法 ， 读 者 可 以 参考 Shiro 官方 文档 ， 这 里 不 再 袭 述 。 





10.6 小 结 





本 章 主要 向 读者 介绍 了 Spring Security 以 及 Shiro 在 Spring Boot 中 的 使 用 。 对 于 Spring 
Security， 有 基于 传统 认证 方式 的 Session 认证 ， 也 有 使 用 OAuth 协议 的 认证 。 一 般 来 说 ， 在 传统 
的 Web 架构 中 ， 使 用 Session 认证 方便 快速 ， 但 是 ， 若 结合 微服 务 、 前 后 端 分 离 等 架构 ， 则 使 用 
OAuth 认证 更 加 方便 ， 具 体 使 用 哪 一 种 ， 需 要 开发 者 根据 实际 情况 进行 取舍 。 而 对 于 Shiro， 虽 然 
功能 不 及 Spring Security 强大 , 但 是 简单 易 用 , 而 且 也 能 胜任 大 部 分 的 中 小 型 项 目 。 当然 , 在 Spring 
Boot 项 目 中 ，Spring Security 的 整合 显然 要 更 加 容易 ， 因 此 可 以 首选 Spring Security。 如 果 开 发 团 
队 对 Spring Security 不 熟悉 却 熟悉 Shiro 的 使 用 , 当然 也 可 以 使 用 Shiro, 这 个 要 结合 具体 情况 来 定 。 


Spring Boot 整合 WebSocket 


本 章 概 要 


e@ 为 什么 需要 WebSocket 
@ WebSocket 简介 
®@ Spring Boot 整合 WebSocket 


11.1 为 什么 需要 WebSocket 


在 HITP 协议 中 ， 所 有 的 请 求 都 是 由 客户 端 发 起 的 ， 由 服务 端 进行 响应 ， 服 务 端 无 法 向 客户 
端 推送 消息 , 但 是 在 一 些 需 要 即时 通信 的 应 用 中 ， 又 不 可 避免 地 需要 服务 端 向 客户 端 推送 消息 , 传 
统 的 解决 方案 主要 有 如 下 几 种 。 

1. 轮 询 

轮 询 是 最 简单 的 一 种 解决 方案 ， 所 谓 轮 询 ， 就 是 客户 端 在 固定 的 时 间 间 隔 下 不 停 地 向 服务 端 
发 送 请 求 ,查看 服务 端 是 否 有 最 新 的 数据 ， 若 服务 端 有 最 新 的 数据 ， 则 返回 给 客户 端 ， 若 服务 端 没 
有 ， 则 返回 一 个 空 的 JSON 或 者 XML 文档 。 轮 询 对 开发 人 员 而 言 实现 方 便 ， 但 是 次 端 也 很 明显 : 
客户 端 每 次 都 要 新 建 HTTP 请 求 , 服务 端 要 处 理 大 量 的 无 效 请 求 , 在 高 并 发 场景 下 会 严重 拖 慢 服务 
端的 运行 效率 ， 同 时 服务 端的 资源 被 极 大 的 浪费 了 ， 因 此 这 种 方式 并 不 可 取 。 
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2. 长 轮 询 
长 轮 询 是 传统 轮 询 的 升级 版 ， 当 聪明 的 工程 师 看 到 轮 询 所 存在 的 问题 后 ， 就 开始 解决 问题 ， 
于 是 有 了 长 轮 询 。 不 同 于 传统 轮 询 ， 在 长 轮 询 中 ， 服 务 端 不 是 每 次 都 会 立即 响应 客户 端的 请 求 ， 只 
有 在 服务 端 有 最 新 数据 的 时 候 才 会 立即 响应 客户 端的 请 求 ， 否 则 服务 端 会 持 有 这 个 请 求 而 不 返回 ， 
直到 有 新 数据 时 才 返 回 。 这 种 方式 可 以 在 一 定 程度 上 节省 网 络 资源 和 服务 器 资源 , 但 是 也 存在 一 些 
问题 ， 例 如 : 
e ”如 果 浏 览 器 在 服务 器 响应 之 前 有 新 数据 要 发 送 ， 就 只 能 创建 一 个 新 的 并 发 请 求 ， 或 者 先 尝 试 
断 掉 当 前 请 求 ， 再 创建 新 的 请 求 。 
e@ TCP 和 HITP 规范 中 都 有 连接 超时 一 说 ， 所 以 所 谓 的 长 轮 询 并 不 能 一 直 持续 ， 服 务 端 和 客户 
端的 连接 需要 定期 的 连接 和 关闭 再 连接 ， 这 又 增 大 了 程序 员 的 工作 量 ， 当 然 也 有 一 些 技术 能 
够 延长 每 次 连接 的 时 间 ， 但 毕竟 是 非 主流 解决 方案 。 
3. Applet 和 Flash 


Applet 和 Flash 都 已 经 是 明日 黄花 ,不 过 在 这 两 个 技术 存在 的 岁月 里 ,除了 可 以 让 我 们 的 HTML 
页 面 更 加 绚丽 之 外 , 还 可 以 解决 消息 推送 问题 ,开发 者 可 以 使 用 Applet 和 Flash 来 模拟 全 双 工 通信 ， 
通过 创建 一 个 只 有 1 个 像素 点 大 小 的 透明 的 Applet 或 者 Flash, 然后 将 之 内 嵌 在 网 页 中 , 再 从 Applet 
或 者 Flash 的 代码 中 创建 一 个 Socket 连接 进行 双向 通信 。 这 种 连接 方式 消除 了 HTTP 协议 中 的 诸多 
限制 ， 当 服务 器 有 消息 发 送 到 客户 端的 时 候 ， 开 发 者 可 以 在 Applet 或 者 Flash 中 调用 JavaScript 函 
数 将 数据 显示 在 页 面 上 , 当 浏览 器 有 数据 要 发 送 给 服务 器 时 也 一 样 ,通过 Applet 或 者 Flash 来 传递 。 
这 种 方式 真正 地 实现 了 全 双 工 通信 ， 不 过 也 有 问题 ， 说 明 如 下 : 

@ 浏览 器 必须 能 够 运行 Java 或 者 Flash。 

e@ 无 论 是 Applet 还 是 Flash 都 存在 安全 问题 。 

e 随 着 HIML 5 标准 被 各 浏览 器 厂商 广泛 支持 ，Flash 下 架 已 经 被 提 上 日 程 (Adobe 宣布 2020 

年 正式 停止 支持 Flash )。 


其 实 ， 传 统 的 解决 方案 不 止 这 三 种 ， 但 是 无 论 哪 种 解决 方案 都 有 自身 的 缺陷 ， 于 是 有 了 
WebSocket。 








11.2 WebSocket 简介 


WebSocket 是 一 种 在 单个 TCP 连接 上 进行 全 双 工 通信 的 协议 ， 已 被 W3C 定 为 标准 。 使 用 
WebSocket 可 以 使 得 客户 端 和 服务 器 之 间 的 数据 交换 变 得 更 加 简单 , 它 允 许 服务 端 主 动向 客户 端 推 
送 数据 。 在 WebSocket 协议 中 ， 浏 览 器 和 服务 器 只 需要 完成 一 次 握手 ， 两 者 之 间 就 可 以 直接 创建 
持久 性 的 连接 ， 并 进行 双向 数据 传输 。 

WebSocket 使 用 了 HTTP/1.1 的 协议 升级 特性 ， 一 个 WebSocket 请 求 首先 使 用 非 正常 的 HITP 
请 求 以 特定 的 模式 访问 一 个 URL， 这 个 URL 有 两 种 模式 ， 分 别 是 ws 和 wss， 对 应 HITP 协议 中 
的 HITP 和 HTTPS， 在 请 求 头 中 有 一 个 Connection:Upgrade 字段 ， 表 示 客 户 端 想 要 对 协议 进行 升 
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级 ， 另 外 还 有 一 个 Upgrade:websocket 字段 ， 表 示 客 户 端 想 要 将 请 求 协议 升级 为 WebSocket 协议 。 
这 两 个 字段 共同 告诉 服务 器 要 将 连接 升级 为 WebSocket 这 样 一 种 全 双 工 协议 ， 如 果 服 务 端 同意 协 
议 升级 ， 那 么 在 握手 完成 之 后 ， 文 本 消息 或 者 其 他 二 进 制 消息 就 可 以 同时 在 两 个 方向 上 进行 发 送 ， 
而 不 需要 关闭 和 重建 连接 。 此 时 的 客户 端 和 服务 端 关系 是 对 等 的 , 它们 可 以 互相 向 对 方 主动 发 送 消 
息 。 和 传统 的 解决 方案 相 比 ，WebSocket 主要 有 如 下 特点 : 
@ WebSocket 使 用 时 需要 先 创建 连接 ， 这 使 得 WebSocket 成 为 一 种 有 状态 的 协议 ， 在 之 后 的 通 
信 过 程 中 可 以 省 略 部 分 状态 信息 (例如 身份 认证 等 )。 
@ WebSocket 连接 在 端口 80 (ws ) 或 者 443 (wss ) 上 创建 ， 与 HITP 使 用 的 端口 相同 ， 这 样 ， 
基本 上 所 有 的 防火 墙 都 不 会 阻止 WebSocket 连接 。 
e。 WebSocket 使 用 HTTP 协议 进行 握手 ， 因 此 它 可 以 自然 而 然 地 集成 到 网 络 浏览 器 和 HTTP 服 
务 器 中 ， 而 不 需要 额外 的 成 本 。 
心跳 消息 (ping 和 pong ) 将 被 反复 的 发 送 ， 进 而 保持 WebSocket 连接 一 直 处 于 活跃 状态 。 
使 用 该 协议 ， 当 消息 启动 或 者 到 达 的 时 候 ， 服 务 端 和 客户 端 都 可 以 知道 。 
WebSocket 连接 关闭 时 将 发 送 一 个 特殊 的 关闭 消息 。 
WebSocket 支持 跨 域 ， 可 以 避免 Ajax 的 限制 。 
HTTP 规范 要 求 浏览 器 将 并 发 连接 数 限制 为 每 个 主机 名 两 个 连接 , 但 是 当 我 们 使 用 WebSocket 
的 时 候 ， 当 握手 完成 之 后 ， 该 限制 就 不 存在 了 ， 因 为 此 时 的 连接 已 经 不 再 是 HTTP 连接 了 。 
日 “WebSocket 协议 支持 扩展 ， 用 户 可 以 扩展 协议 ， 实 现 部 分 自 定义 的 子 协议 。 
@ 更 好 的 二 进 制 支 持 以 及 更 好 的 压缩 效果 。 


WebSocket 既然 具有 这 么 多 优势 ， 使 用 场景 当然 也 是 非常 广泛 的 ， 例 如 : 


。 在线 股 票 网 站 。 
ee 即时 聊天 。 

. 

. 








应 用 集群 通信 。 
系统 性 能 实时 监控 。 


在 了 解 了 这 么 多 WebSocket 的 基本 信息 后 , 接 下 来 看 看 在 Spring Boot 中 如 何 使 用 WebSocket。 
11.3 Spring Boot 整合 WebSocket 


Spring Boot 对 WebSocket 提供 了 非常 友好 的 支持 ， 可 以 方便 开发 者 在 项 目 中 快速 集成 
WebSocket 功能 ， 实 现 单 聊 或 者 群 聊 。 
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11.3.1 消息 群发 
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1. 创建 项 目 
首先 创建 一 个 Spring Boot 项 目 ， 添 加 如 下 依赖 : 


<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-websocket</artifactId> 
</dependency> 

<dependency> 

<groupId>org .webjars</groupId> 
<artifactId>webjars-locator-core</artifactId> 
</dependency> 

<dependency> 

<groupId>org .webjars</groupId> 
<artifactId>sockjs-client</artifactId> 
<version>1.1.2</version> 

</dependency> 

<dependency> 

<groupId>org .webjars</groupId> 
<artifactId>stomp-websocket</artifactId> 
<version>2.3.3</version> 

</dependency> 

<dependency> 

<groupId>org.webjars</groupId> 
<artifactId>jquery</artifactId> 
<version>3.3.1</version> 

</dependency> 


spring-boot-starter-websocket 依赖 是 Web Socket 相关 依赖 ， 其 他 的 都 是 前 端 库 ， 使 用 jar 包 的 





形式 对 这 些 前 端 库 进 行 统一 管理 ， 使 用 webjar 添加 到 项 目 中 的 前 端 库 ， 在 Spring Boot 项 目 中 已 经 
默认 添加 了 静态 资源 过 滤 ， 因 此 可 以 直接 使 用 。 


2. 配置 WebSocket 
Spring 框架 提供 了 基于 WebSocket 的 STOMP 支持 ，STOMP 是 一 个 简单 的 可 互 操作 的 协议 ， 

















通常 被 用 于 通过 中 间 服 务 器 在 客户 端 之 间 进 行 异步 消息 传递 。WebSocket 配置 如 下 : 
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@Configuration 
@EnableWebSocketMessageBroker 
public class WebSocketConfig 
implements WebSocketMessageBrokerConfigurer { 
QOverride 
public void configureMessageBroker (MessageBrokerRegistry config) { 
config.enableSimpleBroker ("/topic"); 
config.setApplicationDestinationPrefixes ("/app"); 
} 
QOverride 
public void registerStompEndpoints (StompEndpointRegistry registry) { 
registry.addEndpoint ("/chat") .withSockJS (); 
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代码 解释 : 

@ 自 定义 类 WebSocketConfig 继承 自 WebSocketMessageBrokerConfigurer 进行 WebSocket 配置 ， 
然后 通过 (@EnableWebSocketMessageBroker 注解 开启 WebSocket 消息 代理 。 

e@ config.enableSimpleBroker("/topic") 表 示 设 置 消息 代理 的 前 级 ， 即 如 果 消 息 的 前 级 是 “/topic”， 
就 会 将 消息 转发 给 消息 代理 ( broker )， 再 由 消息 代理 将 消息 广播 给 当前 连接 的 客户 端 。 

® config.setApplicationDestinationPrefixes("/app") 表 示 配 置 一 个 或 多 个 前 级 ， 通 过 这 些 前 级 过 滤 
出 需要 被 注解 方法 处 理 的 消息 。 例如, 前 组 为 “app” 的 destination 可 以 通过 @MessageMapping 
注解 的 方法 处 理 ， 而 其 他 destination ( 例如 “/topic”“/ queue”) 将 被 直接 交 给 broker 处 理 。 

® registry.addEndpoint("/chat").withSockJSO 则 表示 定义 一 个 前 级 为 “/chat” 的 endPoint， 并 开启 
sockjs 支持 ，sockjs 可 以 解决 浏览 器 对 WebSocket 的 兼容 性 问题 ， 客 户 端 将 通过 这 里 配置 的 
URL 来 建立 WebSocket 连接 。 


3. 定义 Controller 
定义 一 个 Controller 用 来 实现 对 消息 的 处 理 ， 代 码 如 下 : 


@Controller 

public class GreetingController { 
@MessageMapping("/hello") 
@SendTo ("/topic/greetings" 
public Message greeting (Message message) throws Exception { 

return message; 

} 

} 

public class Message { 
private String name; 
private String content; 
// 省 略 getter/setter 





根据 第 2 步 的 配置 ，@MessageMapping("/hello") 注 解 的 方法 将 用 来 接收 “/app/hello” 路 径 发 送 


来 的 消息 , 在 注解 方法 中 对 消息 进行 处 理 后 , 再 将 消息 转发 到 @SendTo 定义 的 路 径 上 , 而 @SendTo 
路 径 是 一 个 前 级 为 “/topie” 的 路 径 ， 因 此 该 消息 将 被 交 给 消息 代理 broker， 再 由 broker 进行 广播 。 


4. 构建 聊天 页 面 
在 resources/static 目录 下 创建 chat.html 页 面 作为 聊天 页 面 ， 代 码 如 下 : 
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<!DOCTYPE html> 

<html lang="en"> 

<head> 

<meta charset="UTF-8"> 

<title> 群 聊 </title> 

<script src="/webjars/jquery/jquery.min.js"></script> 

<script src="/webjars/sockjs-client/sockjs.min.js"></script> 
<script src="/webjars/stomp-websocket/stomp.min.js"></script> 
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<script src="/app.js"></script> 

</head> 

<body> 

<div> 

<label for="name"> 请 输入 用 户 名 : </label> 

<input type="text" id="name"” placeholder=" 用 户 名 "> 
</div> 

<div> 

<button id="connect" type="button"> 连 接 </button> 
<button id="disconnect" type="button" disabled="disabled"> 断 开 连 接 </button> 
</div> 

<div id="chat" style="display: none;"> 

<div> 

<label for="name"> 请 输入 聊天 内 容 : </label> 

<input type="text"” id="content" placeholder=" 聊 天 内 容 "> 
</div> 

<button id="send" type="button"> 发 送 </button> 

<div id="greetings"> 

<div id="conversation" style="display: none"> 群 聊 进行 中 . . .</div> 
</div> 

</div> 


</body> 
</html> 














注意 ， 第 6~8 行 是 引入 外 部 的 JS 库 ， 这 些 JS 库 在 pom.xml 文件 中 通过 依赖 加 入 进来 。app:js 
-个 自 定义 JS， 代码 如 下 : 


var stompClient = null; 
function setConnected(connected) { 
$ ("#connect") .prop ("disabled", connected); 
$("#disconnect") .prop ("disabled", !connected); 
if (connected) { 
$("#conversation") .show(); 
$ ("#chat") .show(); 
} 
else { 
$("#conversation") .hide(); 
$("#chat") .hide(); 
} 
$("#greetings") .html (""); 
} 
function connect() { 
if (!$("#name").val()) { 
return; 
} 
Var socket = new SockJS('/chat'); 
stompClient = Stomp.over(socket); 
stompClient.connect ({}, function (frame) { 
setConnected (true); 
stompClient .subscribe('/topic/greetings', function (greeting) { 
showGreeting (JSON.parse (greeting.body)); 
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25 ]) 7 

26 ]) 7 

27 |} 

28 | function disconnect() { 

29 if (stompClient !== null) { 

30 stompClient.disconnect (); 

21 } 

32 setConnected (false); 

3 | 

34 | function sendName() { 

35 stompClient.send("/app/hello", {}, 

36 JSON. stringify({'name': $("#name") .val(),'content':$("#content") .val()})); 
37 | } 

38 | function showGreeting (message) { 

39 $ ("#greetings") 

40 .append ("<div>" + message.name+":"+message.Content + "</div>"); 
41 | 1} 

42 | $(function () { 

43 $( "#connect" ).click(function() { connect(); }); 

44 $( "#disconnect" ).click(function() { disconnect(); }); 
45 $( "#send" ) .click(function() { sendName(); }); 

46 | DD); 





代码 解释 : 

@ ”connect 方 法 表示 建立 一 个 WebSocket 连接 ， 在 建立 WebSocket 连接 时 ,用户 必须 先 输入 用 户 
名 ， 然 后 才能 建立 连接 。 

日 第 19-26 行 首先 使 用 SockJS 建立 连接 ， 然 后 创建 一 个 STOMP 实例 发 起 连接 请 求 ， 在 连接 成 
功 的 回调 方法 中 ， 首 先 调用 setConnected(true): 方 法 进行 页 面 的 设置 ， 然 后 调用 STOMP 中 的 
subscribe 方法 订阅 服务 端 发 送 回来 的 消息 ， 并 将 服务 端 发 送 来 的 消息 展示 出 来 (使 用 
showGreeting 方法 )。 

e@ 调用 STOMP 中 的 disconnect 方法 可 以 断 开 一 个 WebSocket 连接 。 


5. 测试 
接 下 来 启动 Spring Boot 项 目 进行 测试 ， 在 浏览 器 中 输入 http:Wlocalhost:8080/chat html， 显 示 
结果 如 图 11-1 所 示 。 


7 dl 下 x 
> GC 合 | © localhost:8080/chat.html 


请 输入 用 户 名 : | 用 户 各 
连接 || 断 开 连 接 | 








图 11-1 
用 户 首先 输入 用 户 名 ， 然 后 单 击 “连接 ” 按 钮 ， 结 果 如 图 11-2 所 示 。 
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所 GC 全 | © localhost:8080/chat.html 


请 输入 用 户 名 :” 际 允 求 败 
连接 || 断 开 连 接 | 

请 输入 聊天 内 容 : 如 天 内 容 
发 送 | 














图 11-2 


然后 换 一 个 浏览 器 , 或 者 使 用 Chrome 浏览 器 的 多 用 户 (注意 不 是 多 窗口 ), 重复 刚才 的 步 又 ， 
这 样 就 有 两 个 用 户 连 接 上 了 ， 接 下 来 就 可 以 开始 群 聊 了 (当然 也 可 以 有 更 多 的 用 户 连 接 上 来 )》， 如 
图 11-3 所 示 。 
ow x 
€ C OO |© localhost:8080/chathtml 
请 输入 用 户 名 : 陵 泊 了 由 





连接 | | 断 开 连 接 hd * 

请 输入 聊天 内 容 | 大 家 好 才 是 真 的 好 ! € GC | © localhost:8080/chat.html 
发 送 

江南 一 点 雨 :hello, 大 家 好 ! 请 输入 用 户 名 : 江南 一 点 雨 

独孤 求 败 :大 家 好 才 是 真 的 好 ! 连接 | | 断 开 连 接 


请 输入 聊天 内 容 : jhello 大 家 好 ! 
[az] 

江南 一 点 雨 :hello, 大 家 好 ! 

独 珀 求 败 :大 家 好 才 是 真 的 好 ! 











图 11-3 


11.3.2 ”消息 点 对 点 发 送 


在 11.3.1 小 节 中 介绍 的 消息 发 送 使 用 到 了 @SendTo 注解 ， 该 注解 将 方法 处 理 过 的 消息 转发 到 
broker, 再 由 broker 进行 消息 广播 。 除了 @SendTo 注解 外 , Spring 还 提供 了 SimpMessagingTemplate 
类 来 让 开发 者 更 加 灵活 地 发 送 消 息 ， 使 用 SimpMessagingTemplate 可 以 对 11.3.1 小 节 的 案例 中 的 
Controller 进行 如 下 改造 : 


@Controller 
public class GreetingController { 
QAutowired 
SimpMessagingTemplate messagingTemplate; 
QMessageMapping ("/hello") 
public void greeting (Message message) throws Exception { 
messagingTemplate.convertAndSend("/topic/greetings", message); 


} 


1 
2 
3 
4 
5 
6 
和 
8 
和 





改造 完成 后 ， 直 接 运 行 ， 和 11.3.1 小 节 的 运行 结果 一 致 。 这 里 使 用 SimpMessagingTemplate 进 
行 消息 的 发 送 , 在 Spring Boot 中 , SimpMessagingTemplate 已 经 配置 好 , 开发 者 直接 注入 进来 即 可 。 
使 用 SimpMessagingTemplate， 开 发 者 可 以 在 任意 地 方 发 送 消息 到 broker， 也 可 以 发 送 消息 给 某 一 
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个 用 户 ， 这 就 是 点 对 点 的 消息 发 送 。 接 下 来 看 看 如 何 实现 消息 的 点 对 点 发 送 〈 注 意 本 案例 在 11.3.1 
节 案 例 的 基础 上 完成 )。 








1. 添加 依赖 
既然 是 点 对 点 发 送 ， 就 应 该 有 用 户 的 概念 ， 因 此 ， 首 先 在 项 目 中 加 入 Spring Security 的 依赖 ， 
代码 如 下 : 
1 <dependency> 
车 <groupId>org.springframework.boot</groupId> 
| <artifactId>spring-boot-starter-security</artifactId> 
4 </dependency> 
2. 配置 Spring Security 
对 Spring Security 进行 配置 , 添加 两 个 用 户 , 同时 配置 所 有 地 址 都 认证 后 才能 访问 , 代码 如 下 : 
1 @Configuration 
2 | public class WebSecurityConfig extends WebSecurityConfigurerAdapter { 
3 @Bean 
4 PasswordEncoder passwordEncoder() { 
5 return new BCryptPasswordEncoder (); 
6 } 
7 @Override 
8 protected void configure (AuthenticationManagerBuilder auth) throws Exception { 
9 auth.inMemoryAuthentication () 
10 .withUser ("admin") 
11 .password ("$2a$10$RMuFXGQS5AtHAwOvkUqyvuecpqUSeoxZYqilXzbz50dceRsga.WYiq") 
12 .roles ("admin") 
13 -and() 
14 .withUser ("sang") 
15 .password ("$2a$10$RMuFXGQS5AtHAwOvkUqyvuecpqUSeoxZYqilXzbz50dceRsga.WYiq") 
16 .roles ("user"); 
好 } 
18 @Override 
9 protected void configure (HttpSecurity http) throws Exception { 
20 http.authorizeRequests () 
2 .anyRequest () .authenticated() 
22 -and () 
23 .formLogin () .permitAll (); 
24 } 
证 | 














这 是 





3. 


有 就 是 Spring Security 的 一 个 常规 配置 ， 相 关 配 置 含义 可 以 参考 10.1 节 。 
改造 WebSocket 配置 


接 下 来 对 WebSocket 配置 进行 改造 ， 代 码 如 下 : 


ct 
QE 


onfiguration 
nableWebSocketMessageBroker 


public class WebSocketConfig 





implements WebSocketMessageBrokerConfigurer { 
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5 QOverride 

6 public void configureMessageBroker (MessageBrokerRegistry config) { 

2 config.enableSimpleBroker ("/topic","/queue"); 

8 config.setApplicationDestinationPrefixes ("/app"); 

9 } 

10 QOverride 

p public void registerStompEndpoints (StompEndpointRegistry registry) { 
1 和 registry.addEndpoint ("/chat") .withSockJS () 

13 } 

14 | } 





这 里 的 修改 是 在 config.enableSimpleBroker("/topic"): 方 法 的 基础 上 又 增加 了 一 个 broker 前 级 
“/queue”， 方 便 对 群发 消息 和 点 对 点 消息 进行 管理 。 


4. 配置 Controller 
对 WebSocket 的 Controller 进行 改造 ， 代 码 如 下 : 














1 @Controller 
2 | public class GreetingController { 
3 @Autowired 
4 SimpMessagingTemplate messagingTemplate; 
5 @MessageMapping("/hello") 
6 @SendTo("/topic/greetings") 
7 public Message greeting (Message message) throws Exception { 
8 return message; 
9 } 
10 @MessageMapping ("/chat") 
和 public void chat (Principal principal, Chat chat) { 
12 String from = principal .getName(); 
13 chat .setFrom (from); 
14 messagingTemplate.convertAndSendToUser (chat .getTo(), 
15 | "/queue/chat", chat); 
16 } 
17 |} 
18 | public class Chat { 
19 private String to; 
20 private String from; 
这 private String content; 
22 // 省 略 getter/setter 
2Z3 1 了 
代码 解释 : 
@ 群发 消息 依然 使 用 @SendTo 注解 来 实现 ， 点 对 点 的 消息 发 送 则 使 用 SimpMessagingTemplate 
未 实现. 


ee 第 10-16 行 定 义 了 一 个 新 的 消息 处 理 接 口 ，@MessageMapping("/chat") 注 解 表 示 来 自 

“/app/chat” 路 径 的 消息 将 被 chat 方法 处 理 。chat 方法 的 第 一 个 参数 Principal 可 以 用 来 获取 
当前 登录 用 户 的 信息 ， 第 二 个 参数 则 是 客户 端 发 送 来 的 消息 。 

日 在 chat 方法 中 ， 首先 获取 当前 用 户 的 用 户 名 ， 设 置 给 chat 对 象 的 fom 属性 ， 再 将 消息 发 送 
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出 去 ， 发 送 的 目标 用 户 就 是 chat 对 象 的 to 属性 值 。 
@ 消息 发 送 使 用 的 方法 是 convertAndSendToUser， 该 方法 内 部 调用 了 convertAndSend 方法 ， 并 
对 消息 路 径 做 了 处 理 ， 部 分 源码 如 下 : 





public void convertAndSendToUser (String user, String destination, Object payload, 
@Nullable Map<String, Object> headers, 

@Nullable MessagePostProcessor postProcessor) 
throws MessagingException { 


super.convertAndSend (this.destinationPrefix + user + destination, 
payload, headers, postProcessor); 


. 








OCPD 





这 里 destinationPrefix 的 默认 值 是 “/user”， 也 就 是 说 消息 的 最 终 发 送 路 径 是 “/user/ 用 户 名 


/queue/chat ”。 
@ chat 是 一 个 普通 的 JavaBean，to 属性 表示 消息 的 目标 用 户 ，from 表示 消息 从 哪里 来 ，content 
则 是 消息 的 主体 内 容 。 


5. 创建 在 线 聊 天 页 面 
在 resources/static 目录 下 创建 onlinechat html 页 面 作为 在 线 聊 天 页 面 ， 代 码 如 下 : 


<!DOCTYPE html> 
<html lang="en"> 
<head> 
<meta charset="UTF-8"> 
<title> 单 聊 </title> 
<script src="/webjars/jquery/jquery.min.js"></script> 
<script src="/webjars/sockjs-client/sockjs.min.js"></script> 
<script src="/webjars/stomp-websocket/stomp.min.js"></script> 
<script src="/chat.js"></script> 

0 | </head> 

11 | <body> 

12 | <div id="chat"> 

13 | <div id="chatsContent"> 





PooonmoDPpp 


14 | </div> 

15 | <div> 

16 请 输入 聊天 内 容 : 

17 | <input type="text" id="content" placeholder=" 聊 天 内 容 "> 
18 目标 用 户 : 


19 | <input type="text" id="to" placeholder=" 目 标 用 户 "> 
20 | <button id="send" type="button"> 发 送 </button> 








21 | </div> 
22 | </div> 
23 | </body> 
24 | </html> 





这 个 页 面 和 chat.html 页 面 基本 类 似 ， 不 同 的 是 ， 为 了 演示 方便 ， 这 里 需要 用 户 手动 输入 目标 
用 户 名 。 另 外 ， 还 有 一 个 chatjs 文件 ， 代 码 如 下 : 
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时 var stompClient = null; 
4 function connect() { 
3 Var socket = new SockJS('/chat'); 
4 stompClient = Stomp.over (socket); 
5 stompClient.connect ({}, function (frame) { 
6 stompClient.subscribe('/user/queue/chat', function (chat) { 
7 showGreeting (JSON.parse (chat .body) ) ; 
8 1); 
9 1D); 
10 | } 
11 | function sendMsg() { 
12 stompClient.send("/app/chat", {}, 
13 JSON.stringify({'content':$("#content") .val (), 
14 'to':$("#to") .val ()})); 
15 |} 
16 | function showGreeting (message) { 
17 $("#chatsContent") 
18 .append ("<div>" + message.fromt":"+message.Content + "</div>"); 
19 | } 
20 | $(function () { 
21 connect () 
22 $( "#send" ).click(function() { sendMsg(); }); 
23 | )) 








chatjs 文件 基本 与 前 文 的 appjs 文件 内 容 一 致 ， 差 异 主要 体现 在 三 个 地 方 : 


@ ”连接 成 功 后 ， 订 阅 的 地 址 为 “/user/queue/chat*"， 该 地 址 比 服 务 端 配 置 的 地 址 多 了 “/user” 前 
级 ， 这 是 因为 SimpMessagingTemplate 类 中 自动 添加 了 路 径 前 级 。 

@ ”聊天 消息 发 送 路 径 为 “/app/chat”。 

@ 发送 的 消息 内 容 中 有 一 个 to 字段 ， 该 字段 用 来 描述 消息 的 目标 用 户 。 

6. 测试 

经 过 如 上 几 个 步骤 之 后 ， 一 个 点 对 点 的 聊天 服务 就 搭建 成 功 了 ， 接 下 来 直接 在 浏览 器 地 址 栏 


中 输入 http:Wlocalhost:8080/onlinechat html， 首 先 会 自动 跳 转 到 Spring Security 的 默认 登录 页 面 , 分 
别 使 用 一 开始 配置 的 两 个 用 户 admin/123 和 sang/123 登录 ， 登 录 成 功 后 ， 就 可 以 开始 在 线 聊天 了 ， 
如 图 11-4 所 示 。 





EE x 
Re GC OO |© localhost:8080/onlinechat.html 





sang: 你 好 管理 员 
请 输入 聊天 内 容 : 你 好 ,sang 目标 用 户 : |sang 发 送 
Jusm x 


中 CG | © Ilocalhost8080/onlinechathtml 


admin: 你 好 ，sang 
请 输入 聊天 内 容 : 你 好 管理 员 目标 用 户 : jadmin 发 送 











图 11-4 
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11.4 小 结 


本 章 主要 向 读者 介绍 了 Spring Boot 整合 WebSocket， 整 体 来 说 ， 经 过 Spring Boot 自动 化 配置 
之 后 的 WebSocket 使 用 起 来 还 是 非常 方便 的 。 通 过 @MessageMapping 注解 配置 消息 接口 ， 通 过 
@SendTo 或 者 SimpMessagingTemplate 进行 消息 转发 , 通过 简单 的 几 行 配置 ,就 能 实现 点 对 点 、 点 
对 面 的 消息 发 送 。 在 企业 信息 管理 系统 中 ， 一 般 即 时 通信 、 通 告发 布 等 功能 都 会 用 到 WebSocket。 


消息 服务 


本 章 概要 


® JMS 
® AMQP 


消息 队列 (Message Queue) 是 一 种 进程 间或 者 线程 间 的 异步 通信 方式 ， 使 用 消息 队列 ， 消 息 
生产 者 在 产生 消息 后 , 会 将 消息 保存 在 消息 队列 中 ,直到 消息 消费 者 来 取 走 它 ， 即 消息 的 发 送 者 和 
接收 者 不 需要 同时 与 消息 队列 交互 。 使 用 消息 队列 可 以 有 效 实现 服务 的 解 看, 并 提高 系统 的 可 靠 性 
以 及 可 扩展 性 。 目 前 ， 开 源 的 消息 队列 服务 非常 多 ， 如 Apache ActiveMQ、RabbitMQ 等 ， 这 些 产 
品 也 就 是 常 说 的 消息 中 间 件 。 


12.1 JMS 


12.1.1 JMS 简介 





JMS (Java Message Service) 即 Java 消息 服务 ， 它 通过 统一 JAVA API 层面 的 标准 ， 使 得 多 
个 客户 端 可 以 通过 JMS 进行 交互 , 大 部 分 消息 中 间 件 提供 商都 对 JMS 提供 支持 。JMS 和 ActiveMQ 
的 关系 就 象 JDBC 和 JDBC 驱动 的 关系 。JMS 包括 两 种 消息 模型 : 点 对 点 和 发 布 者 /订阅 者 ， 同 时 
JMS 仅 支 持 Java 平台 。 
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12.1.2 ”Spring Boot 整合 JMS 


由 于 JMS 是 一 套 标准 ， 因 此 Spring Boot 整合 JMS 必然 就 是 整合 JMS 的 某 一 个 实现 ， 本 案例 
以 ActiveMQ 为 例 来 看 Spring Boot 如 何 进行 整合 。 

1. ActiveMQ 简介 

Apache ActiveMQ 是 一 个 开源 的 消息 中 间 件 ， 它 不 仅 完全 支持 JMS1.1 规范 ， 而 且 支 持 多 种 编 
程 语言 ， 例 如 C、C++、C#、Delphi、Erlang、Adobe Flash、Haskell、Java、JavaScript、Perl、PHP、 
Pike、Python 和 Ruby 等 ， 也 支持 多 种 协议 ， 例 如 OpenWire、REST、STOMP、WS-Notification、 
MQTT、XMPP 以 及 AMQP。Apache ActiveMQ 也 提供 了 对 Spring 框架 的 支持 ， 可 以 非常 容易 地 霸 
入 Spring 中 ， 同 时 它 也 提供 了 集群 支持 。 

2. ActiveMQ 安装 





- 般 情 况 下 ,ActiveMQ 都 是 安装 在 Linux 上 的 ,因此 ,本 案例 的 安装 环境 为 CentOS 7,ActiveMQ 
版 本 为 5.15.4， 安 装 步 又 如 下 (注意 ， 要 运行 ActiveMQ，CentOS 上 必须 安装 Java 运行 环境 ，Java 
运行 环境 的 安装 比较 简单 ， 读 者 可 以 自行 安装 ， 这 里 不 做 介绍 ) : 

步 又 014 下 载 ActiveMQ， 命 令 如 下 : 








步骤 024 解压 下 载 文件 ， 命 令 如 下 : 


1 | Tar -zxvf apache-activemq-5.15.4-bin.tar.gz 
步 又 034 启动 ActiveMQ， 命令 如 下 : 


1 | cd apache-activemq-5.15.4 
2 | cd bin/ 
3 | ./activemq start 


步骤 04 访问 。 
ActiveMQ 启动 成 功 后 ， 关 闭 CentOS 防火 墙 ， 在 物理 机 浏览 器 中 输入 地 址 : 


http://192.168.66.129:8161/， 其 中 192.168.66.129 是 虚拟 机 地 址 ，8161 是 ActiveMQ 默认 端口 号 ， 如 
果 能 看 到 图 12-1 中 的 页 面 ， 表 示 ActiveMQ 已 经 启动 成 功 了 。 
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ActiveMQ 启动 成 功 后 ， 单 击 Manage ActiveMQ broker 超 链接 进入 管理 员 控 制 台 ， 默 认 用 户 名 
和 密码 都 是 atmin， 如 图 12-2 所 示 。 
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图 12-2 


3. 整合 Spring Boot 

Spring Boot 为 ActiveMQ 配置 提供 了 相关 的 “Starter”， 因 此 整合 非常 容易 。 
首先 创建 Spring Boot 项 目 ， 添 加 ActiveMQ 依赖 ， 代 码 如 下 : 

<dependency> 

<groupId>org.springframework.boot</groupId> 


<artifactId>spring-boot-starter-activemq</artifactId> 
</dependency> 


然后 在 application.properties 中 进行 连接 配置 ， 代 码 如 下 : 


xODP 











spring.activemq.broker-url=tcp://192.168.66.129:61616 
spring.activemq.packages.trust-all=true 
spring.activemq.user=admin 
Spring.activemq.password=admin 








AODP 





首先 配置 broker 地 址 , 默认 端口 是 61616, 然后 配置 信任 所 有 的 包 , 这 个 配置 是 为 了 支持 发 送 
对 象 消息 ， 最 后 配置 ActiveMQ 的 用 户 名 和 密码 。 

接 下 来 在 项 目 配置 类 中 提供 一 个 消息 队列 Bean， 该 Bean 的 实例 就 由 ActiveMQ 提供 ， 代 码 如 
下 : 





Spring BootApplication 
public class DemoApplication { 
public static void main(String[] args) { 
SpringApplication.run (DemoApplication.class, args); 
} 
Q@Bean 
Queue queue() { 
return new ActiveMOQueue ("amq"); 


} 


oOoODPp 








六 
So 
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接 下 来 创建 一 个 JMS 组 件 来 完成 消息 的 发 送 和 接收 ， 代 码 如 下 : 











1 @Component 

public class JmsComponent { 

3 QAutowired 

4 JmsMessagingTemplate messagingTemplate; 

5 QAutowired 

6 Queue queue; 

时 public void send(Message msg) { 

8 messagingTemplate.convertAndSend (this.queue, msg); 
9 } 

10 QUJmsListener (destination = "amq") 

1 public void receive (Message msg) { 

12 System.out .println("receive:" + msg); 
13 } 

14|} 

15 | public class Message implements Serializable{ 
16 private String content; 

17 private Date date; 

18 // 省 略 getter/setter 

19 | 3 





JmsMessagingTemplate 是 由 Spring 提供 的 一 个 JMS 消息 发 送 模板 ， 可 以 用 来 方便 地 进行 消息 
的 发 送 ， 消 息 发 送 方法 convertAndSend 的 第 一 个 参数 是 消息 队列 ， 第 二 个 参数 是 消息 内 容 ， 本 案 
例 演 示 一 个 对 象 消息 。@JmsListener 注解 则 表示 相应 的 方法 是 一 个 消息 消费 者 , 消息 消费 者 订阅 的 
消息 destination 为 amq。 

经 过 上 面 的 配置 ， 就 可 以 在 Spring Boot 中 使 用 ActiveMQ 了 。 


4. 测试 
编写 测试 类 ， 完 成 消息 发 送 测试 ， 代 码 如 下 : 


@RunWith (SpringRunner.class) 
@Spring BootTest 
public class DemoApplicationTests { 
QAutowired 
JmsComponent jmsComponent; 
QTest 
public void contextLoads () { 
Message msg = new Message () 7 
msg.setContent ("hello jms!") 7 
msg.setDate (new Date () ) 
jmsComponent .send (msg) 


FFPiceDmnamwmmwm 
上 己 


> 
DL 











记 
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在 测试 类 中 注入 JImsComponent 组 件 ， 然 后 调用 该 组 件 的 send 方法 发 送 一 个 Message 对 象 。 
确认 ActiveMQ 已 经 启动 ， 然 后 启动 Spring Boot，Spring Boot 项 目 启动 成 功 后 ， 执 行 该 单元 
测试 方法 ， 观 察 Spring Boot 项 目 日 志 ， 如 图 12-3 所 示 。 
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2018-08-01 08:48:01.241 INF0 11088 — [ main] com. example., demd 
receive:lMessage {content=" hello jms!’, date=Wed Aug 01 08:48:16 CST 2018} 
图 12-3 


12.2.1 AMQP 简介 


AMQP (Advanced Message Queuing Protocol， 高 级 消息 队列 协议 ) 是 一 个 线路 层 的 协议 规范 ， 
而 不 是 API 规范 (例如 JMS) 。 由 于 AMQP 是 一 个 线路 层 协 议 规范 ， 因 此 它 天 然 就 是 跨 平台 的 ， 
就 像 SMTP、HTTP 等 协议 一 样 , 只 要 开发 者 按照 规范 的 格式 发 送 数据 , 任何 平台 都 可 以 通过 AMQP 
进行 消息 交互 。 像 目前 流行 的 StormMQ、RabbitMQ 等 都 实现 了 AMQP。 





12.2.2 ”Spring Boot 整合 AMQP 


和 JMS 一 样 , 使 用 AMQP 也 是 使 用 AMQP 的 某 个 实现 , 本 案例 以 RabbitMQ 为 例 向 读者 介绍 
AMQP 的 使 用 。 

1. RabbitMQ 简介 

RabbitMQ 是 一 个 实现 了 AMQP 的 开源 消息 中 间 件 ， 使 用 高 性 能 的 Erlang 编写 。RabbitMQ 具 
有 可 靠 性 、 支 持 多 种 协议 、 高 可 用 、 支 持 消 息 集群 以 及 多 语言 客户 端 等 特点 ， 在 分 布 式 系统 中 存储 
转发 消息 ， 具 有 不 错 的 性 能 表现 。 

2. RabbitMQ 的 安装 

由 于 RabbitMQ 使 用 Erlang 编写 ,因此 需要 先 安装 Erlang 环境 ,在 CentOS 7 中 安装 Erlang 21.0 
的 步骤 如 下 : 





1 | # 下 载 安装 包 

2 | wget http://erlang.org/download/otp src 21.0.tar.gz 
3 | # 解 压 文件 

4 tar -zxvf otp src 21.0.tar.gz 
与 cd otp_src_21.0 

6 | # 编 译 

7 ./otp build autoconf 

8 ./configure 

a make 

10 | # 安 装 

11 | make install 

12 | # 检 验 

13 Lerl 











最 后 一 步 是 检验 ， 如 果 看 到 如 图 12-4 所 示 的 效果 图 ， 表 示 安 装 成 功 。 
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图 12-4 


Erlang 安装 成 功 后 ， 接 下 来 安装 RabbitMQ。 
由 于 yum 仓库 中 默认 的 Erlang 版 本 较 低 ， 因 此 首先 需要 将 最 新 的 Erlang 包 添 加 到 yum 源 中 ， 
执行 如 下 命令 : 


于 [vi /etc/yum. repos.d/rabbitmq-erlang.repo 











添加 如 下 内 容 : 





1 | [rabbitmq-erlang] 

2 | name=rabbitmq-erlang 

3 | baseurl=https://dl.bintray.com/rabbitmq/rpm/erlang/21/el1/7 

4 | gpgcheck=1 

5 | gpgkey=https://dl1.bintray.com/rabbitmq/Keys/rabbitmq-release-signing-key.asc 
6 | repo_gpgcheck=0 

7 | enabled=1 





添加 成 功 后 ， 清 除 原 有 缓存 并 创建 新 缓存 ， 命 令 如 下 : 


1 | yum clean all 
2 um makecache 


准备 工作 完成 后 ， 接 下 3 


wget https://dl.bintray.com/rabbitmq/all/rabbitmq-server/3.7.7/rabbitmq-server- 





就 可 以 安装 RabbitMQ 了 ， 首 先 下 载 文件 : 


3.7.7-1.el17.noarch.rpm 





下 载 完成 后 开始 安装 : 

[ywm install rabbitmg-server-3.7.7-1.elT.noarch.rpn | 
安装 过 程 中 ， 若 提示 缺少 socat 依赖 ， 则 安装 socat 依赖 即 可 ， 命 令 如 下 : 

1 | yum install socat 

安装 成 功 后 ， 接 下 来 就 可 以 启动 RabbitMQ 并 进行 用 户 管理 了 ， 命 令 如 下 : 

# 启 动 


service rabbitmq-server start 

# 查 看 状态 

rabbitmqctl] status 

# 开 启 web 插件 

rabbitmq-plugins enable rabbitmq management 
# 重 启 

service rabbitmq-server restart 

# 添 加 一 个 用 户 名 为 sang， 密 码 为 123 的 用 户 
rabbitmqctl add user sang 123 

# 设 置 sang 用 户 的 角色 为 管理 员 


























oammmwm 


上 哺 
Oo 
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12 | rabbitmqctl set user tags sang administrator 
13 | # 配 置 sang 用户 可 以 远程 登录 


14 | rabbitmqct1 set permissions -p / sang ".*"".*"".*" 








RabbitMQ 启动 成 功 后 ， 默 认 有 一 个 guest 用 户 ， 但 是 该 用 户 只 能 在 本 地 登录 ， 无 法 远程 登 
录 ， 因 此 本 案例 中 添加 了 一 个 新 的 用 户 sang， 也 有 具有 管理 员 身份 ， 同 时 可 以 远程 登录 。 当 
RabbitMQ 启动 成 功 后 ,在 物理 机 浏览 器 上 输入 虚拟 机 地 址 : http:/192.168.66.130:15672， 如 
果 看 到 如 图 12-5 所 示 的 页 面 ， 表 示 RabbitMQ 已 经 启动 成 功 。 使 用 sang/123 进行 登录 ， 登 
录 成 功 后 如 图 12-6 所 示 。 


旨 RabbitMQ Managemer x 
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由 Rabbit 


Username; 


Password: 
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图 12-6 





3. 整合 Spring Boot 


Spring Boot 为 AMQP 提供 了 自动 化 配置 依赖 spring-boot-starter-amqp， 因 此 首先 创建 Spring 
Boot 项 目 并 添加 该 依赖 ， 代 码 如 下 : 


<dependency> 





<groupId>org.springframework.boot</groupId> 


<artifactId>spring-boot-starter-amqp</artifactId> 
</dependency> 





项 目 创建 成 功 后 ， 在 application properties 中 配置 RabbitMQ 的 基本 连接 信息 ， 代 码 如 下 : 
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spring.rabbitmq.host=192.168.66.130 
spring.rabbitmq.port=5672 
spring.rabbitmq.username=sang 
spring.rabbitmq.password=123 
接 下 来 进行 RabbitMQ 配置 ,在 RabbitMQ 中 ,所 有 的 消息 生产 者 提交 的 消息 都 会 交 由 Exchange 
进行 再 分 配 ，Exchange 会 根据 不 同 的 策略 将 消息 分 发 到 不 同 的 Queue 中 。RabbitMQ 中 一 共 提供 了 
4 种 不 同 的 Exchange 策略 ， 分 别 是 Direct、Fanout、Topic 以 及 Header， 这 4 种 不 同 的 策略 中 ， 前 
3 种 的 使 用 频率 较 高 ,第 4 种 的 使 用 频率 较 低 ， 下 面 分 别 对 这 4 种 不 同 的 ExchangeType 予以 介绍 。 
(1) Direct 
DirectExchange 的 路 由 策略 是 将 消息 队列 绑 定 到 一 个 DirectExchange 上 ， 当 一 条 消息 到 达 

DirectExchange 时 会 被 转发 到 与 该 条 消息 routing key 相同 的 Queue 上 ， 例 如 消息 队列 名 为 

“hello-queue”， 则 routingkey 为 “hello-queue” 的 消息 会 被 该 消息 队列 接收 。DirectExchange 的 配 
置 如 下 : 





必 wm 




















a @Configuration 
2 | public class RabbitDirectConfig { 
3 public final static String DIRECTNAME = "sang-direct"; 
4 QBean 
5 Queue queue() { 
6 return new Queue ("hello-queue"); 
7 } 
8 QBean 
9 DirectExchange directExchange() { 
10 return new DirectExchange (DIRECTNAME, true, false); 
11 } 
12 QBean 
13 Binding binding() { 
14 return BindingBuilder.bind(queue()) 
35 .to (directExchange () ) .with ("direct"); 
16 } 
LE 
代码 解释 : 
@ 首先 提供 一 个 消息 队列 Queue， 然 后 创建 一 个 DirectExchange 对 象 ， 三 个 参数 分 别 是 名 字 、 
重启 后 是 否 依然 有 效 以 及 长 期 未 用 时 是 否 删除 。 
日 创建 一 个 Binding 对 象 ， 将 Exchange 和 Queue 绑 定 在 一 起 。 
® DirectExchange 和 Binding 两 个 Bean 的 配置 可 以 省 略 掉 ， 即 如 果 使 用 DirectExchange， 只 配 
置 一 个 Queue 的 实例 即 可 。 
接 下 来 配置 一 个 消费 者 ， 代 码 如 下 : 
1 | acomponent 
2 | public class DirectReceiver { 
3 @RabbitListener (queues = "hello-queue") 
4 public void handlerl (String msg) { 
5 System.out .println ("DirectReceiver:" + msg); 
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了 外 和 


通过 @RabbitListener 注解 指定 一 个 方法 是 一 个 消息 消费 方法 , 方法 参数 就 是 所 接收 到 的 消息 。 
然后 在 单元 测试 类 中 注入 一 个 RabbitTemplate 对 象 来 进行 消息 发 送 ， 代 码 如 下 : 


@RunWith (SpringRunner.class 
@Spring BootTest 
public class RabbitmqApplicationTests { 
QAutowired 
RabbitTemplate rabbitTemplate; 
QTest 
public void directTest() { 
rabbitTemplate.convertAndSend ("hello-queue", "hello direct!"); 




















POAMAoODLp 





确认 RabbitMQ 已 经 启动 ， 然 后 启动 Spring Boot 项 目 ， 启 动 成 功 后 ， 运 行 该 单元 测试 方法 ， 
在 Spring Boot 控制 台 打 印 日 志 ， 如 图 12-7 所 示 。 


2018-08-02 10:26:05.190 INF0 11696 一 [ 


DirectReceiver :hello direct! 





图 12-7 


(2) Fanout 
FanoutExchange 的 数据 交换 策略 是 把 所 有 到 达 FanoutExchange 的 消息 转发 给 所 有 与 它 绑 定 的 
Queue， 在 这 种 策略 中 ，routingkey 将 不 起 任何 作用 ，FanoutExchange 的 配置 方式 如 下 : 











1 @Configuration 

2 | public class RabbitFanoutConfig { 

3 public final static String FANOUTNAME = "sang-fanout"; 
4 QBean 

5 FanoutExchange fanoutExchange() { 

6 return new FanoutExchange (FANOUTNAME, true, false); 
8 QBean 

9 Queue queueOne() { 

10 return new Queue ("queue-one"); 

11 

12 QBean 

13 Queue queueTwo () { 

14 Teturn new Queue ("queue-two"); 

5 

16 QBean 

和 了 Binding bindingone() { 

18 return BindingBuilder.bind(queueOne () ) .to (fanoutExchange ()); 
19 

20 QBean 

21 Binding bindingTwo() { 
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22 return BindingBuilder.bind (queueTwo()) .to(fanoutExchange ()); 











在 这 里 首先 创建 FanoutExchange， 参 数 的 含义 与 创建 DirectExchange 参数 的 含义 一 致 ， 然 后 
创建 两 个 Queue， 再 将 这 两 个 Queue 都 绑 定 到 FanoutExchange 上 。 接 下 来 创建 两 个 消费 者 ， 代 码 
如 下 : 





@Component 
public class FanoutReceiver { 
Q@RabbitListener (queues = "queue-one") 
public void handlerl (String message) { 
System.out .println("FanoutReceiver:handlerl:" + message); 
} 
@RabbitListener (queues = "queue-two") 
public void handler2 (String message) { 
System.out .println("FanoutReceiver:handler2:" + message); 


1 
2 
3 
4 
5 
6 
7 
8 
9 
1 
1 





两 个 消费 者 分 别 消费 两 个 消息 队列 中 的 消息 ， 然 后 在 单元 测试 中 发 送 消息 ， 代 码 如 下 : 


@RunWith (SpringRunner.class 
@Spring BootTest 
public class RabbitmqApplicationTests { 
@Autowired 
RabbitTemplate rabbitTemplate; 
QTest 
public void fanoutTest() { 
rabbitTemplate 
.convertAndSend (RabbitFanoutConfig.FANOUTNAME, 
null, "hello fanout!"); 


Pp Dprp 
Po 





上 
MD 








注意 , 这 里 发 送 消息 时 不 需要 routingkey, 指定 exchange 即 可 ,routingkey 可 以 直接 传 一 个 null。 
确认 RabbitMQ 已 经 启动 ， 然 后 启动 Spring Boot 项 目 ， 启 动 成 功 后 ， 执 行 单元 测试 方法 ， 控 
制 台 打印 日 志 如 图 12-8 所 示 。 





2018-08-02 11:21:55.654 INF0 11804 -一 [ 
FanoutReceiver :handler?2:hello fanout! 


FanoutReceiver :handlerl :hello fanout! 





图 12-8 


可 以 看 到 ， 一 条 消息 发 送出 去 之 后 ， 所 有 和 该 FanoutExchange 绑 定 的 Queue 都 收 到 了 消息 。 
(3) Topic 
TopicExchange 是 比较 复杂 也 比较 灵活 的 一 种 路 由 策略 ， 在 TopicExchange 中 ，Queue 通过 
routingkey 绑 定 到 TopicExchange 上 ， 当 消息 到 达 TopicExchange 后 ，TopicExchange 根据 消息 的 
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routingkey 将 消息 路 由 到 一 个 或 者 多 个 Queue 上 。TopicExchange 配置 如 下 : 





2 
3 
4 
5 
6 
2 
8 
9 





@Configuration 
public class RabbitTopicConfig { 


. 


public final static String TOPICNAME = "sang-topic"; 
QBean 
TopicExchange topicExchange() { 

return new TopicExchange (TOPICNAME, true, false); 


QBean 
Queue xiaomi() { 
return new Queue ("xiaomi"); 


QBean 
Queue huawei() { 
return new Queue ("huawei"); 


QBean 
Queue phone() { 
return new Queue ("phone"); 





QBean 
Binding xiaomiBinding() { 
return BindingBuilder.bind (xiaomi ()) .to(topicExchange () ) 
-with("xiaomi .#"); 
} 
QBean 
Binding huaweiBinding() { 
return BindingBuilder.bind (huawei ()) .to(topicExchange () ) 
.with("huawei.#"); 
} 
QBean 
Binding phoneBinding() { 
return BindingBuilder.bind (phone()) .to(topicExchange ()) 
-with("#.phone.#"); 








代码 解释 : 


首先 创建 TopicExchange， 参 数 和 前 面 的 一 致 。 然 后 创建 三 个 Queue, 第 一 个 Queue 用 来 存储 
和 “xiaomi” 有 关 的 消息 ， 第 二 个 Queue 用 来 存储 和 “huawei” 有 关 的 消息 ， 第 三 个 Queue 
用 来 存储 和 “phone” 有 关 的 消息 。 

将 三 个 Queue 分 别 绑 定 到 TopicExchange 上 ， 第 一 个 Binding 中 的 “xiaomi#” 表 示 消 息 的 
routingkey 凡是 以 “xiaomi” 开 头 的 ， 都 将 被 路 由 到 名 称 为 “xiaomi” 的 Queue 上 ; 第 二 个 
Binding 中 的 “huawei#” 表示 消息 的 routingkey 凡是 以 “huawei” 开 头 的 ， 都 将 被 路 由 到 名 
称 为 “huawei” 的 Queue 上 ; 第 三 个 Binding 中 的 喷 phone.#” 则 表示 消息 的 routingkey 中 凡 
是 包含 “phone” 的 ， 都 将 被 路 由 到 名 称 为 “phone” 的 Queue 上 。 


第 12 章 消息 服务 | 225 





接 下 来 针对 三 个 Queue 创建 三 个 消费 者 ， 代 码 如 下 : 





ic 站 mw 











Component 
public class TopicReceiver { 
@RabbitListener (queues = "phone") 
public void handlerl (String message) { 
System.out .println("PhoneReceiver:" + message); 
} 
@RabbitListener (queues = "xiaomi") 
public void handler2 (String message) { 
System.out .println ("XiaoMiReceiver:"+t+message); 
} 
Q@RabbitListener (queues = "huawei") 
public void handler3 (String message) { 
System.out .println ("HuaWeiReceiver:"+message); 


} 


然后 在 单元 测试 中 进行 消息 的 发 送 ， 代 码 如 下 : 


@RunWith (SpringRunner.class) 
@Spring BootTest 
public class RabbitmqApplicationTests { 
@Autowired 
RabbitTemplate rabbitTemplate; 
QTest 
public void topicTest() { 
rabbitTemplate.convertAndSend (RabbitTopicConfig.TOPICNAME, 
"xiaomi .news", "小 米 新 闻 . .") ; 
rabbitTemplate.convertAndSend (RabbitTopicConfig.TOPICNAME, 
"huawei .news", "华为 新 闻 .."); 
rabbitTemplate.convertAndSend (RabbitTopicConfig.TOPICNAME, 
"xiaomi .phone", "小 米 手机 .."); 
rabbitTemplate.convertAndSend (RabbitTopicConfig.TOPICNAME, 
"huawei .phone", "华为 手机 .."); 
rabbitTemplate.convertAndSend (RabbitTopicConfig.TOPICNAME, 
"phone .news", "手机 新 闻 .."); 
} 








根据 RabbitTopicConfig 中 的 配置 ， 第 一 条 消息 将 被 路 由 到 名 称 为 “xiaomi” 的 Queue 上 ， 第 

















二 条 消息 将 被 路 由 到 名 为 “huawei” 的 Queue 上 ， 第 三 条 消息 将 被 路 由 到 名 为 “xiaomi” 以 及 名 为 
“phone” 的 Queue 上 ， 第 四 条 消息 将 被 路 由 到 名 为 “huawei” 以 及 名 为 “phone” 的 Queue 上 ， 最 
后 一 条 消息 则 将 被 路 由 到 名 为 “phone” 的 Queue 上 。 


确认 RabbitMQ 已 经 启动 ， 然 后 启动 Spring Boot 项 目 ， 启 动 成 功 后 ， 运 行 单元 测试 方法 ， 控 


制 台 打印 日 志 12-9、 图 12-10 所 示 。 
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(4 





2018-08-02 12:13:12.419 INF0 5700 一 [ 
HuaWeiReceiver :华为 新 闻 . . 
XiaoliReceiver :小 米 新 闻 . . 

PhoneReceiver :小 米 手 机 . . 

PhoneReceiver :手机 新 闻 . . 


图 12-9 








2018-08-02 12:13:21.928 INF0 10532 -一 
HuaWeiReceiver :华为 手机 . 

XiaoliReceiver :小 米 手机 . . 

PhoneReceiver :华为 手机 . . 





图 12-10 


) Header 


HeadersExchange 是 一 种 使 用 较 少 的 路 由 策略 ，HeadersExchange 会 根据 消息 的 Header 将 消息 


路 由 到 不 同 的 Queue 上 ， 这 种 策略 也 和 routingkey 无 关 ， 配 置 如 下 : 


口 虽 ammwm 








ec 


onfiguration 
public class RabbitHeaderConfig { 
public final static String HEADERNAME = "sang-header"; 
QBean 
HeadersExchange headersExchange() { 
return new HeadersExchange (HEADERNAME, true, false); 


} 
QBean 
Queue queueName() { 

return new Queue ("name-queue"); 
} 
QBean 
Queue queueage () { 

return new Queue ("age-queue"); 
} 
@Bean 
Binding bindingName() { 

Map<String, Object> map = new HashMap<>(); 

map.put ("name", "sang"); 

return BindingBuilder .bind (queueName ()) 

.to (headersExchange () ) .whereAny (map) .match (); 

} 
Q@Bean 
Binding bindingAge() { 

return BindingBuilder.bind (queueAge()) 

-to (headersExchange () ) .where ("age") .exists (); 








这 是 





有 的 配置 大 部 分 和 前 面 介绍 的 一 样 ,差别 主要 体现 的 Binding 的 配置 上 ,第 一 个 bindingName 
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方法 中 ，whereAny 表示 消息 的 Header 中 只 要 有 一 个 Header 匹配 上 map 中 的 key/value， 就 把 该 消 
息 路 由 到 名 为 “name-queue” 的 Queue 上 , 这 里 也 可 以 使 用 whereAll 方法 , 表示 消息 的 所 有 Header 
都 要 匹配 。whereAny 和 whereAll 实际 上 对 应 了 一 个 名 为 x-match 的 属性 。bindingAge 中 的 配置 则 
表示 只 要 消息 的 Header 中 包含 age， 无 论 age 的 值 是 多 少 ， 都 将 消息 路 由 到 名 为 “age-queue” 的 
Queue 上 。 

接 下 来 创建 两 个 消息 消费 者 ， 代 码 如 下 : 





ommammmwmn 








@Component 
public class HeaderReceiver { 





注意 ， 这 里 的 参数 用 byte 数组 接收 。 然 后 在 单元 测试 中 创建 消息 的 发 送 方法 ， 这 里 消息 的 发 
送 也 和 routingkey 无 关 ， 代 码 如 下 : 





RabbitListener (queues = "name-queue") 
public void handlerl (byte[] msg) { 
System.out .println ("HeaderReceiver:name:" 
+ new String(msg, 0, msg.length)); 


} 
@RabbitListener (queues = "age-queue") 
public void handler2 (byte[] msg) { 
System.out .println ("HeaderReceiver:age:" 
+ new String(msg, 0, msg.length)); 




















1 @RunWith (SpringRunner.class) 
2 @Spring BootTest 
3 |public class RabbitmqApplicationTests { 
4 @Autowired 
5 RabbitTemplate rabbitTemplate; 
6 QTest 
时 public void headerTest() { 
8 Message nameMsg = MessageBuilder 
9 .withBody ("hello header! name-queue".getBytes()) 
10 .setHeader ("name", "sang") .build(); 
11 Message ageMsg = MessageBuilder 
12 .WithBody ("hello header! age-queue" .getBytes () ) 
13 .SetHeader ("age"，"99") .build(); 
14 rabbitTemplate. send (RabbitHeaderConfig.HEADERNAME, null, ageMsg); 
15 rabbitTemplate. send (RabbitHeaderConfig .HEADERNAME, null, nameMsg); 
16 } 
Ey 
这 里 创建 两 条 消息 , 两 条 消息 具有 不 同 的 header, 不 同 header 的 消息 将 被 发 送 到 不 同 的 Queue 
中 。 


确认 RabbitMQ 已 经 启动 ， 然 后 启动 Spring Boot 项 目 ， 启 动 成 功 后 ， 执 行 单元 测试 方法 ， 结 


果 如 图 





12-11 所 示 。 
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2018-08-02 12:37:55.730 INF0 660 一 【[ 
HeaderReceiver :name :hello header! name—queue 


HeaderReceiver:age :hello header! age-queue 





图 12-11 
12.3 小 结 


本 章 向 读者 介绍 了 Spring Boot 对 消息 服务 的 支持 ， 传 统 的 JMS 和 AMQP 各 有 千秋 ，JMS 从 
API 的 层面 对 消息 中 间 件 进行 了 统一 ，AMQP 从 协议 层面 来 统一 ，JMS 不 支持 跨 平 台 ， 而 AMQP 
天 然 地 具备 跨 平台 功能 。AMQP 支持 的 消息 模型 也 更 加 丰富 ， 除 了 本 章 介 绍 的 ActiveMQ 和 
RabbitMQ 之 外 ，Spring Boot 也 能 方便 地 整合 Kafka、Artemis 等 ， 开 发 者 可 根据 实际 情况 选择 合 i 
的 消息 中 间 件 。 


ee ee e e 
芒 
仔 
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13.1 邮件 发 送 


邮件 发 送 是 一 个 非常 常见 的 功能 ， 注 册 时 的 身份 认证 、 重 要 通知 发 送 等 都 会 用 到 邮件 发 送 。 
Sun 公司 提供 了 JavaMail 用 来 实现 邮件 发 送 ,但 是 配置 烦琐 ，Spring 中 提供 了 JavaMailSender 用 来 
简化 邮件 配置 ，Spring Boot 则 提供 了 MailSenderAutoConfiguration 对 邮件 的 发 送 做 了 进一步 简化 。 
本 节 就 来 看 看 Spring Boot 中 如 何 发 送 邮件 。 


13.1.1 发 送 前 的 准备 


本 节 以 QQ 邮箱 为 例 向 读者 介绍 邮件 的 发 送 过 程 。 使 用 QQ 邮箱 发 送 邮 件 ， 首 先 要 申请 开通 
POP3/SMTP 服务 或 者 IMAP/SMTP 服务 。SMTP 全 称 为 Simple Mail Transfer Protocol， 译作 简单 邮 
件 传输 协议 ， 它 定义 了 邮件 客户 端 软 件 与 SMTP 服务 器 之 间 ， 以 及 SMTP 服务 器 与 SMTP 服务 器 
之 间 的 通信 规则 。 也 就 是 说 ，aaa@qq.com 用 户 先 将 邮件 投递 到 腾讯 的 SMTP 服务 器 ， 这 个 过 程 就 
使 用 了 SMTP 协议 ， 然 后 腾讯 的 SMTP 服务 器 将 邮件 投递 到 网 易 的 SMTP 服务 器 ， 这 个 过 程 依然 
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使 用 了 SMTP 协议 ，SMTP 服务 器 就 是 用 来 接收 邮件 的 。 而 POP3 全 称 为 Post Office Protocol3， 译 
作 邮 局 协议 ， 它 定义 了 邮件 客户 端 与 POP3 服务 器 之 间 的 通信 规则 。 该 协议 在 什么 场景 下 会 用 到 
呢 ? 当 邮 件 到 达 网 易 的 SMTP 服务 器 之 后 ，111@163.com 用 户 需要 登录 服务 器 查看 邮件 ， 这 个 时 
候 就 用 上 该 协议 了 : 邮件 服务 商会 为 每 一 个 用 户 提供 专门 的 邮件 存储 空间 ，SMTP 服务 器 收 到 邮件 
之 后 , 将 邮件 保存 到 相应 用 户 的 邮件 存储 空间 中 ， 如果 用 户 要 读 取 邮 件 , 就 需要 通过 邮件 服务 商 的 
POP3 邮件 服务 器 来 完成 。 至 于 IMAP 协议 ， 则 是 对 POP3 协议 的 扩展 ， 功 能 更 强 ， 作 用 类 似 。 下 
介绍 QQ 邮箱 开通 POP3/SMTP 服务 或 者 IMAP/SMTP 服务 的 步骤 。 


步骤 014 登录 QQ 邮箱 ， 依 次 单 击 顶部 的 设置 按钮 ( 见 图 13-1 ) 和 账户 按钮 ( 见 图 13-2 )。 

















图 13-1 


默认 帐户 昵称 : 。 ]ames Gosling 
(你 发 出 的 所 有 邮件 ， 发 件 人 将 显示 你 的 郎 箱 昵 和 你， 你 还 可 以 给 每 个 帐户 单独 设置 呢 称 。) 





图 13-2 


步 又 024 在 账户 选项 卡 下 方 找到 POP3/SMTP 服务 ， 单 击 后 方 的 “开启 ”按钮 ， 如 图 13-3 所 


POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV 服 务 


POP3/SMTP 服 务 (如 何 使 用 Foxmail 等 软件 收发 部 件 ? ) 
IMAP/SMTP 服 务 (什么 是 IMAP， 它 又 星 各 何 没 置 ? ) 





Exchange 服 务 (什么 是 Exchange， 它 又 是 如 何 设置 ? ) 
CardDAV/CalDAV 服 务 (什么 是 CardDAV/CalDAV， 记 又 是 如 何 设置 ? ) 
(POP3/IMAP/SMTP/CardDAV/CalDAV 服 务 均 支持 SSL 连接。 如何 设 置 ? ) 


13-3 





单 击 “ 开 启 ” 按 钮 后 ,按照 引导 步骤 发 送 短信 ， 操作 成 功 后 , 会 获取 一 个 授权 码 ( 见 图 13-4) ， 
将 授权 码 保存 下 来 过 后 使 用 。 
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开启 POP3/SMTP 


成 功 开启 POP3/SMTP 服 务 ,在 第 三 方 客户 调 
登录 时 ， 族 码 框 请 输入 以 下 授权 码 


电子 备件 。 maileamGqqcom 





密码 eeeeeeeee 








图 13-4 
拿 到 授权 码 后 ， 准 备 工作 就 完成 了 。 
13.1.2 发送 
1. 环境 搭建 
使 用 Spring Boot 发 送 邮 件 , 环境 搭建 非常 容易 ， 首 先 在 创建 项 目 时 添加 邮件 依赖 ,代码 如 下 









<dependency> 
<groupId>org.springframework.boot</groupId> 

<artifactId>spring-boot-starter-mail</artifactId> 
</dependency> 


项 目 创建 成 功 后 ， 在 application.properties 中 完成 邮件 基本 信息 配置 ， 代 码 如 下 : 






AODPP 


spring.mail.host=smtp.qq.com 

spring.mail.port=465 

spring.mail.username=xxx@qq.com 

spring.mail.password=13.1.1 小 节 申 请 到 的 授权 码 

spring.mail.default-encoding=UTF-8 
spring.mail.properties.mail.smtp.socketFactory.class=javax.net.ssl.SSLSocketFactor 


y 
spring.mail.properties.mail.debug=true 


这 里 配置 了 邮件 服务 器 的 地 址 、 端 口 ( 可 以 是 465 或 者 587) 、 用 户 的 账号 和 密码 以 及 默认 编 
码 、SSL 连接 配置 等 ， 最 后 开启 debug， 这 样 方便 开发 者 查看 邮件 发 送 日 志 。 注 意 ，SSL 的 配置 可 
以 在 QQ 邮箱 帮助 中 心 看 到 相关 文档 ， 如 图 13-5 所 示 。 

完成 这 些 配 置 之 后 ， 基 本 的 邮件 发 送 环 境 就 搭建 成 功 了 ， 接 下 来 就 可 以 发 送 邮 件 了 。 邮 件 从 
简单 到 复杂 有 多 种 类 型 ， 下 面 分 别 予 以 介绍 。 


aummwm 
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IM 人 Gil 98 邮 区 | 帮助 中 心 


如 何 设置 POP3/SMTP 的 SSL 加 密 方式 ? 


便 用 SSL 的 适用 配 于 如 下 : 

接收 邮件 服务 器 : pop.qq.com， 酉 用 SSL， 问 口号 995 

发 送 邮 件 服务 器 : smtp.qq.com， 全 用 5SL， 端 号 45532587 ] 

账户 各: 从 的 QQ 邮箱 财 户 名 《各 果 您 是 VIP 帐号 或 Foxmai 帐 号 ， 账 户 名 过 要 壮 写 完 吾 的 邮件 地 址 ; 
密码 : 外 的 QQ 邮 入 它 码 

电子 邮件 地 址 : 您 的 QQ 部 入 的 完 圣 部 仁 地 址 




















图 13-5 

2. 发 送 简 单 邮件 

创建 一 个 MailService 用 来 封装 邮件 的 发 送 ， 代 码 如 下 : 
1 @Component 
2 public class MailService { 
3 @Autowired 
4 JavaMailSender javaMailSender; 
5 public void sendSimpleMail (String from,String tovString cc 
6 String subject, String content) { 
芝 SimpleMailMessage simpMsg = new SimpleMailMessage(); 
8 simpMsg. setFrom (from); 
9 simpMsg.setTo (to); 
10 simpMsg.setCc (cc); 
11 simpMsg.setSubject (subject); 
12 simpMsg. setText (content); 
13 javaMailSender .send (simpMsg); 
14 } 








代码 解释 : 


®@ JavaMailSender 是 Spring Boot 在 MailSenderPropertiesConfiguration 类 中 配置 好 的 ,该 类 在 Mail 
自动 配置 类 MailSenderAutoConfiguration 中 导入 ， 因 此 这 里 注入 JavaMailSender 就 可 以 使 用 


本 

esendSimpleMail 方法 的 5 个 参数 分 别 表示 邮件 发 送 者 、 收 件 人 、 抄 送 人 、 邮 件 主题 以 及 邮件 
内 容 。 

e 简单 邮件 可 以 直接 构建 一 个 SimpleMailMessage 对 象 进行 配置 ， 配 置 完 成 后 ， 通 过 
JavaMailSender 将 邮件 发 送出 去 。 


配置 完成 后 ， 在 单元 测试 中 写 一 个 测试 方法 进行 测试 ， 代 码 如 下 : 








@RunWith (SpringRunner.class 

@Spring BootTest 

public class SendmailApplicationTests { 
QAutowired 
MailService mailService; 
Test 


ao 必 wm 
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7 public void sendSimpleMail() { 

8 mailService.sendSimpleMail ("1510161612@qq.com", 
9 "584991843@qq.com", 

10 | "1470249098@qq.com", 











11 | "测试 邮件 主题 "， 
12 | "测试 邮件 内 容 ") ; 
13 } 
14 | } 
执行 该 方法 ， 即 可 看 到 邮件 发 送 成 功 ， 如 图 13-6 所 示 。 
有 《 收 件 箱 vV 
测试 邮件 主题 
水 流 云 在 隐藏 
江南 一 点 十 
1470249098 
测试 邮件 内 容 








图 13-6 


3. 发 送 带 附件 的 邮件 
要 发 送 一 个 带 附件 的 邮件 也 非常 容易 ， 通 过 调用 Attachment 方法 即 可 添加 附件 ， 该 方法 调用 
多 次 即 可 添加 多 个 附件 。 在 MailService 中 添加 如 下 方法 : 


1 |public void sendAttachFileMail (String from, String to, 

2 String subject, String content, File file) { 

有 try { 

4 MimeMessage message = javaMailSender.createMimeMessage(); 
5 MimeMessageHelper helper = new MimeMessageHelper (message, true); 
6 helper.setFrom(from); 

有 helper.setTo (to); 

8 helper.setSubject (subject); 

9 helper.setText (content); 

10 helper.addAttachment (file.getName (), file); 

11 javaMailSender.send (message); 

12 } catch (MessagingException e) { 

13 e.printstackTrace (); 

14 起 

15 | } 





这 里 使 用 MimeMessageHelper 简化 了 邮件 配置 ， 它 的 构造 方法 的 第 二 个 参数 true 表示 构造 一 
个 multipart message 类 型 的 邮件 ，multipart message 类 型 的 邮件 包含 多 个 正文 、 附 件 以 及 内 髓 资源 ， 
邮件 的 表现 形式 更 加 丰富 。 最 后 通过 addAttachment 方法 添加 附件 。 

在 单元 测试 中 添加 如 下 方法 进行 测试 : 
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QTest 
public void sendAttachFileMail() { 
mailService.sendAttachFileMail ("1510161612@qq.com", 
"584991843@qq.com", 
"测试 邮件 主题 "， 
"测试 邮件 内 容 "， 
new File("E:\\ 邮 件 附件 .docx") ) 





co Dawmemwm 


} 
执行 单元 测试 方法 ， 邮 件 发 送 结果 如 图 13-7 所 示 。 


《 收 件 箱 Vv 











测试 邮件 主题 


水 流 云 在 


测试 邮件 内 容 


docx 


向 
图 13-7 





4. 发 送 带 图 片 资 源 的 邮件 
有 的 邮件 正文 中 可 能 要 插入 图 片 ， 使 用 FileSystemResource 可 以 实现 这 一 功能 ， 代 码 如 下 : 





和 public void sendMailWithImg (String from, String to, 

2 String subject, String content, 

3 String[] srcPath,String[] resIds) { 

4 if (srcPath.length != resIds.length) { 

5 System.out .println ("发送 失败 "); 

6 return; 

7 } 

8 try { 

9 MimeMessage message = javaMailSender.createMimeMessage(); 
10 MimeMessageHelper helper = new MimeMessageHelper (message,true); 
4 有 helper .setFrom(from); 

1 helper.setTo (to); 

13 helper.setSubject (subject); 

14 helper .setText (content, true); 

15 for (int i = 0; i < srcPath.length; i++) { 








16 FileSystemResource res = new FileSystemResource (new File(srcPath[i])); 
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17 helper.addInline (resIds[i], res); 
18 ; 

19 javaMailSender.send (message); 

20 } catch (MessagingException e) { 

21 System.out .println ("发送 失败 ") ; 

22 } 

231} 





在 发 送 邮 件 时 分 别传 入 图 片 资源 路 征 和 资源 id，, 通过 FileSystemResource 构造 静态 资源 , 然后 
调用 addInline 方法 将 资源 加 入 邮件 对 象 中 ,注意 , 在 调用 MimeMessageHelper 中 的 setText 方法 时 ， 
第 二 个 参数 true 表示 邮件 正文 是 HTML 格式 的 ， 该 参数 不 传 默 认为 false。 

接 下 来 在 测试 类 中 添加 如 下 方法 进行 测试 : 





1 @Test 

2 | public void sendMailWithImg() { 

3 mailService.sendMailWithImg ("1510161612@qq.com", 
4 "584991843@qq.com", 

5 | "测试 邮件 主题 (图 片 ) "， 

6 | "<qiv>hello, 这 是 一 封 带 图 片 资 源 的 邮件 : "+ 

7 | "这 是 图 片 1: <div><img src='cid:p01'/></div>" + 

8 | "这 是 图 片 2: <div><img src='cid:p02'/></div>" + 

9 | "</qiv>", 

10 new String[]{"C:\\Users\\sang\\Pictures\\pl.png", 
11 | "Cc:\\Users\\sang\\Pictures\\p2.png"}, 

4 new String[]{"p01", "p02"}); 

13 1 让 





邮件 的 正文 是 一 段 HTML 文本 , 用 cid 标注 出 两 个 静态 资源 , 分 别 为 p01 和 p02。 执行 该 方法 ， 
邮件 发 送 结果 如 图 13-8 所 示 。 
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测试 邮件 主题 (图 片 ) 

水 流 云 在 详情 

hello, 这 是 一 封 带 图 片 资源 的 邮件 : 这 是 图 片 1: 
© EC 
i 
Ch = -= 

Milees | 帮助 中 心 

~ oRror spgess un 
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5. 使 用 FreeMarker 构建 邮件 模板 


对 于 格式 复杂 的 邮件 ， 如 果 采 用 字符 串 进行 HTML 拼接 ， 不 但 容易 出 错 ， 而 且 不 易于 维护 ， 
使 用 HTML 模板 可 以 很 好 地 解决 这 一 问题 。 使 用 FreeMarker 构建 邮件 模板 ， 首 先 加 入 FreeMarker 
依赖 ， 代 码 如 下 : 





<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-freemarker</artifactId> 
</dependency> 


ODP 





然后 在 MailService 中 添加 如 下 方法 : 


public void sendHtmlMail (String from, String to, 
String subject, String content){ 

try { 
MimeMessage message = javaMailSender.createMimeMessage(); 
MimeMessageHelper helper = new MimeMessageHelper (message, true); 
helper.setTo (to); 
helper.setFrom(from); 
helper.setSubject (subject); 
helper.setText (content, true); 
javaMailSender .send (message); 

} catch (MessagingException e) { 
System.out .println ("发送 失 败 ") ; 


cammmwm 


} 











接 下 来 在 resources 目录 下 创建 包 目录 作为 模板 存放 位 置 ， 在 该 目录 下 创建 mailtemplate ftl 作 
为 邮件 模板 ， 内 容 如 下 : 














1 | <qiv> 邮 箱 激活 </div> 
2 | <qdiv> 您 的 注册 信息 是 : 
3 <table border="1"> 
4 <tr> 
5 | <tq> 用 户 名 </tq> 
6 <td>$ {username}</td> 
| 
8 <tr> 
9 | <td> 用 户 性 别 </td> 
10 | <td>${genderj</td> 
二 [</tr> 
12 | </table> 
13 | </div> 
14 | <div> 
15 | <a href="http://www.baidu.com"> 核 对 无 误 请 点 击 本 链接 激活 邮箱 </a> 
16 | </div> 
当然 ， 再 创建 一 个 简单 的 User 实体 类 ， 代 码 如 下 : 
1 public class User { 
2 private String username; 
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3 private String gender; 
4 // 省 上 getter/setter 
5 1} 
最 后 ， 在 单元 测试 类 中 添加 如 下 方法 进行 测试 : 
@Test 
public void sendHtmlMail (){ 
try { 
Configuration configuration = 
new Configuration (Configuration.VERSION 2 3 0); 
ClassLoader loader = SendmailApplication.class.getClassLoader (); 
configuration 
.SetClassLoaderForTemplateLoading (loader, "ft1"); 
Template template = configuration.getTemplate ("mailtemplate.ft1"); 
StringWriter mail = new StringWriter(); 
User user = new User(); 
user.setGender (" 男 "); 
user.setUsername ("江南 一 点 雨 ") ; 
template.process (user, mail); 
mailService.sendHtmlMail ("1510161612@qq.com", 
"584991843@qq.com", 
"测试 邮件 主题 "， 
mail.tostring()); 
9 } catch (Exception e) { 
20 e.printstackTrace () ; 
21 } 











cammmwmn 


oar Po 














首先 配置 FreeMarker 模板 位 置 ， 配置 模板 文件 ， 然 后 结合 User 对 象 泻 染 模板 ， 将 泻 染 结果 发 
送出 去 ， 执 行 该 方法 ， 邮 件 发 送 结果 如 图 13-9 所 示 。 
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用 户 性 别 | 男 
于 要 激活 邮箱 
图 13-9 


6. 使 用 Thymeleaf 构建 邮件 模板 


既然 可 以 使 用 FreeMarker 构建 邮件 模板 ， 当 然 也 可 以 使 用 Thymeleaf 构建 邮件 模板 ， 使 用 
Thymeleaf 构建 邮件 模板 相对 来 说 更 加 方便 。 使 用 Thymeleaf 构建 邮件 模板 ， 首 先 添加 Thymeleaf 
依赖 ， 代 码 如 下 : 


和 | <aependency> 
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2 <groupId>org.springframework.boot</groupId> 
3 <artifactId>spring-boot-starter-thymeleaf</artifactId> 
4 </dependency> 


Thymeleaf 邮件 模板 默认 位 置 是 在 resources/templates 目录 下 ,创建 相应 的 目录 ， 然 后 创建 邮 
件 模板 mailtemplate.html， 代 码 如 下 : 


<html lang="en" xmlns:th="http://www.thymeleaf.org"> 
<head> 

<meta charset="UTF-8"> 
<title> 邮 件 </title> 

</head> 

<body> 

<div> 邮 箱 激活 </div> 
<div> 您 的 注册 信息 是 : 

<table border="1"> 

10 | <tr> 

11 | <tqd> 用 户 名 </tq> 

12 | <td th:text="${username}"></td> 
13 | < 

14 | <tr> 

15 | <td> 用 户 性 别 </td> 

16 | <td th:text="${gender}j"></td> 














Dowmcmwm 


17 | </tr> 

18 | </table> 

19 | </div> 

20 | <div> 

21 | <a href="http://www.baidu.com"> 核 对 无 误 请 点 击 本 链接 激活 邮箱 </a> 
22 | </div> 

23 | </body> 

24 | </html> 





然后 在 单元 测试 类 中 添加 如 下 代码 进行 测试 : 


@Autowired 
TemplateEngine templateEngine; 
@Test 
public void sendHtmlMailThymeleaf() { 
Context ctx = new Context (); 
ctx.setVariable ("username", "sang"); 
ctx.setVariable ("gender", " 男 "); 
String mail = templateEngine.process ("mailtemplate.html", ctx); 
mailService.sendHtmlMail ("1510161612@qq.com", 
"584991843@qq.com", 
"测试 邮件 主题 "， 


mail); 








E 





不 同 于 FreeMarker，Thymeleaf 提供 了 TemplateEngine 来 对 模板 进行 演 染 ， 通 过 Context 构造 
模板 中 变量 需要 的 值 ， 这 种 方式 比 FreeMarker 构建 邮件 模板 更 加 方便 。 最 后 执行 该 测试 方法 ， 发 
送 的 邮件 如 图 13-10 所 示 。 
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图 13-10 


这 几 种 不 同 的 邮件 发 送 方式 基本 上 能 满足 大 部 分 的 业务 需求 ， 读 者 在 实际 开发 中 可 以 合理 选择 。 


13.2 定时 任务 


定时 任务 是 企业 级 开发 中 最 常见 的 功能 之 一 ， 如 定时 统计 订单 数 、 数 据 库 备份 、 定 时 发 送 短 
言 和 邮件 、 定 时 统计 博客 访客 等 ， 简 单 的 定时 任务 可 以 直接 通过 Spring 中 的 @Scheduled 注解 来 实 


现 ， 复 杂 的 定时 任务 则 可 以 通过 集成 Quartz 来 实现 ， 下 面 分 别 予 以 介绍 。 


13.2.1 @Scheduled 


@Scheduled 是 由 Spring 提供 的 定时 任务 注解 ， 使 用 方便 ， 配 置 简单 ， 可 以 解决 工作 中 大 部 分 


的 定时 任务 需求 ， 使 用 方式 如 下 : 
1. 创建 工程 


首先 创建 一 个 普通 的 Spring Boot Web 工程 ， 添 加 Web 依赖 即 可 ， 代 码 如 下 : 








<dependency> 
<groupId>org.springframework.boot</groupId> 


<artifactId>spring-boot-starter-web</artifactId> 
</dependency> 


AODP 








2. 开启 定时 任务 
在 项 目 启动 类 上 添加 @EnableScheduling 注解 开启 定时 任务 ， 代 码 如 下 : 
@Spring BootApplication 
QEnableScheduling 
public class ScheduledApplication { 
public static void main(String[] args) { 


SpringApplication.run(ScheduledApplication.class, args); 
} 


am 
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3. 配置 定时 任务 
定时 任务 主要 通过 @Scheduled 注解 进行 配置 ， 代 码 如 下 : 


@Component 
public class MySchedule { 
@Scheduled (fixedDelay = 1000) 
public void fixedDelay() { 
System.out .println("fixedDelay:"+new Date()); 


@Scheduled (fixedRate = 2000) 
public void fixedRate() { 
System.out.println("fixedRate:"+new Date()); 


@Scheduled (initialDelay = 1000, fixedRate = 2000) 
public void initialDelay() { 
System.out.println("initialDelay:"+new Date()); 


@Scheduled(cron = "0 * * * * 2") 
public void cron() { 
System.out.println("cron:"+new Date()); 














代码 解释 : 


e 通过 @Scheduled 注解 来 标注 一 个 定时 任务 , 其 中 fixedDelay = 1000 表示 在 当前 任务 执行 结束 
1 秒 后 开启 另 一 个 任务 ，fixedRate = 2000 表示 在 当前 任务 开始 执行 2 秒 后 开启 另 一 个 定时 任 
务 ，initialDelay = 1000 则 表示 首次 执行 的 延迟 时 间 。 

ee 在 @Scheduled 注解 中 也 可 以 使 用 cron 表达 式 , cron 二 "0**** 3" 表示 该 定时 任务 每 分 钟 执行 
一 次 。 


配置 完成 后 ， 接 下 来 启动 Spring Boot 项 目 即 可 ， 定 时 任务 部 分 打印 日 志 如 图 13-11 所 示 。 





fixedRate:lon Aug 06 10:20:54 CST 2018 
fixedDelay :Mon Aug 06 10:20:54 CST 2018 
2018-08-06 10:20:54.878 INF0 3416 一 


2018-08-06 10:20:54.884 INHF0 3416 一 【 
initialDelay :Mon Aug 06 10:20:55 CST 2018 
fixedDelay :Mon Aug 06 10:20:55 CST 2018 





图 13-11 


13.2.2 Quartz 


1. Quartz 简介 


Quartz 是 一 个 功能 丰富 的 开源 作业 调度 库 , 它 由 Java 写成 , 可 以 集成 在 任何 Java 应 用 程序 中 ， 
包括 Java SE 和 Java EE 等 。 使 用 Quartz 可 以 创建 简单 或 者 复杂 的 执行 计划 , 它 支 持 数据 库 、 集 群 、 
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插件 以 及 邮件 ， 并 且 支 持 cron 表达 式 ， 具 有 极 高 的 灵活 性 。Spring Boot 中 集成 Quartz 和 Spring 中 
集成 Quartz 比较 类 似 ， 主 要 提供 三 个 Bean: JobDetail、Trigger 以 及 SchedulerFactory。 


2. 整合 Spring Boot 
首先 创建 Spring Boot 项 目 ， 添 加 Quartz 依赖 ， 代 码 如 下 : 











1 <dependency> 
4 <groupId>org.springframework.boot</groupId> 
3 <artifactId>spring-boot-starter-quartz</artifactId> 
4 </dependency> 
然后 创建 两 个 Job， 代 码 如 下 : 
1 QComponent 
2 |public class MYFirstJob { 
吉 public void sayHello() { 
4 System.out.println("MYFirstJob:sayHello:"+new Date()); 
5 } 
6 } 
2 public class MySecondJob extends QuartzJobBean { 
8 private String name; 
9 public void setName (String name) { 
10 this.name = name; 
11 } 
12 QOverride 
13 protected void executeInternal (JobExecutionContext context){ 
14 System.out .println("hello:"+name+":"+new Date()); 
15 } 
16 | } 





Job 可 以 是 一 个 普通 的 JavaBean， 如 果 是 普通 的 JavaBean， 那 么 可 以 先 添加 @Component 注解 
将 之 注册 到 Spring 容器 中 。Job 也 可 以 继承 抽象 类 QuartzJobBean， 若 继承 自 QuartzJobBean， 则 需 
要 实现 该 类 中 的 executeInternal 方法 ， 该 方法 在 任务 被 调用 时 使 用 。 接 下 来 创建 QuartzConfig 对 
JobDetail 和 Trigger 进行 配置 ， 代 码 如 下 : 











3 @Configuration 

public class QuartzConfig { 

3 Q@Bean 

4 MethodInvokingJobDetailFactoryBean jobDetaill() { 
5 MethodInvokingJobDetailFactoryBean bean = 

6 new MethodInvokingJobDetailFactoryBean(); 
7 bean.setTargetBeanName ("myFirstJob"); 

8 bean.setTargetMethod ("sayHello"); 

9 return bean; 

10 } 

11 Bean 

2 JobDetailFactoryBean jobDetail2() { 

13 JobDetailFactoryBean bean = new JobDetailFactoryBean(); 
14 bean.setJobClass (MySecondJob.class); 

15 JobDataMap jobDataMap = new JobDataMap (); 














242 | Spring Boot+Vue 全 栈 开 发 实战 

16 jobDataMap.put ("name", "sang"); 

17 bean. setJobDataMap (jobDataMap); 

18 | bean.setDurability (true); 

19 return bean; 

20 } 

21 QBean 

22 SimpleTriggerFactoryBean simpleTrigger() { 

23 SimpleTriggerFactoryBean bean = 

24 new SimpleTriggerFactoryBean () ; 

人 3 bean.setJobDetail (jobDetaill () .getObject ()); 
26 bean.setRepeatCount (3); 

27 bean.setStartDelay (1000); 

28 bean.setRepeatInterval (2000); 

二 return bean; 

30 } 

31 QBean 

32 CronTriggerFactoryBean cronTrigger() { 

33 CronTriggerFactoryBean bean = 

34 new CronTriggerFactoryBean(); 

35 bean.setJobDetail (jobDetail2() .getObject ()); 
36 bean.setCronExpression(™* 大 # # # 2"); 

37 return bean; 

38 } 

39 QBean 

40 SchedulerFactoryBean schedulerFactory() { 

41 SchedulerFactoryBean bean = new SchedulerFactoryBean(); 
42 SimpleTrigger simpleTrigger = simpleTrigger() .getObject (); 
43 CronTrigger cronTrigger = cronTrigger() .getObject (); 
44 bean.setTriggers (simpleTrigger, cronTrigger); 
45 return bean; 

46 } 

47 | } 








代码 解释 : 


JobDetail 的 配置 有 两 种 方式 : 第 一 种 方式 通过 MethodInvokingJobDetailFactoryBean 类 配置 
JobDetail, 只 需要 指定 Job 的 实例 名 和 要 调用 的 方法 即 可 , 注册 这 种 方式 无 法 在 创建 JobDetail 
时 传递 参数 ; 第 二 种 方式 是 通过 JobDetailFactoryBean 来 实现 的 ,这 种 方式 只 需要 指定 JobClass 
即 可 ， 然 后 可 以 通过 JobDataMap 传递 参数 到 Job 中 ，Job 中 只 需要 提供 属性 名 ， 并 且 提 供 一 
个 相应 的 set 方法 即 可 接收 到 参数 。 

Trigger 有 多 种 不 同 实现 ， 这 里 展示 两 种 常用 的 Trigger: SimpleTrigger 和 CronTrigger， 这 两 
种 Trigger 分 别 使 用 SimpleTriggerFactoryBean 和 CronTriggerFactoryBean 进行 创建 。 

在 SimpleTriggerFactoryBean 对 象 中 ,首先 设置 JobDetail， 然 后 通过 setRepeatCount 配置 任务 
循环 次 数 ，setStartDelay 配置 任务 启动 延迟 时 间 ，setRepeatInterval 配置 任务 的 时 间 间 隔 。 

在 CronTriggerFactoryBean 对 象 中 ， 则 主要 配置 JobDetail 和 Cron 表达 式 。 

最 后 通过 SchedulerFactoryBean 创建 SchedulerFactory， 然 后 配置 Trigger 即 可 。 





经 过 这 几 步 的 配置 ， 定 时 任务 就 配置 成 功 了 。 接 下 来 启动 Spring Boot 项 目 ， 控 制 台 打印 日 志 
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如 图 13-12 所 示 。 





hello:sang:Mon Aug 06 23:08:48 CST 2018 
2018-08-06 23:08:48.906 INF0 5680 一 【 
2018-08-06 23:08:48.910 INF0 5680 一 【 
hello:sang:lMon Aug 06 23:08:49 CST 2018 
MyFirstJob:sayHello:Mon Aug 06 23:08:49 CST 2018 
hello:sang:lon Aug 06 23:08:50 CST 2018 
hello:sang:lon Aug 06 23:08:51 CST 2018 
MyFirstJob:sayHello:Mon Aug 06 23:08:51 CST 2018 
hello:sang:lon Aug 06 23:08:52 CST 2018 
hello:sang:lon Aug 06 23:08:53 CST 2018 
MyFirstJob:sayHello:Mon Aug 06 23:08:53 CST 2018 
hello:sang:Mon Aug 06 23:08:54 CST 2018 
hello:sang:lon Aug 06 23:08:55 CST 2018 
ltyFirstJob:sayHello:lon Aug 06 23:08:55 CST 2018 
hello:sang:Mon Aug 06 23:08:56 CST 2018 
hello:sang:lon Aug 06 23:08:57 CST 2018 
hello:sang:Mon Aug 06 23:08:58 CST 2018 
hello:sang:Mon Aug 06 23:08:59 CST 2018 


图 13-12 








MyFirstJob 在 重复 了 3 次 之 后 便 不 再 执行 ，MySecondJob 则 每 秒 执行 一 次 ， 一 直 执行 下 去 。 


13.3 批 处 理 


13.3.1 Spring Batch 简介 


Spring Batch 是 一 个 开源 的 、 全 面 的 、 轻 量 级 的 批 处 理 框架 ， 通 过 Spring Batch 可 以 实现 强大 
的 批 处 理应 用 程序 的 开发 。Spring Batch 还 提供 记录 /跟踪 、 事 务 管 理 、 作 业 处 理 统计 、 作 业 重 启 以 
及 资源 管理 等 功能 。Spring Batch 结合 定时 任务 可 以 发 挥 更 大 的 作用 。 

Spring Batch 提供 了 ItemReader、ItemProcessor 和 ItemWriter 来 完成 数据 的 读 取 、 处 理 以 及 写 
出 操作 , 并 且 可 以 将 批 处 理 的 执行 状态 持久 化 到 数据 库 中 。 接 下 来 通过 一 个 简单 的 数据 复制 向 读者 
展示 Spring Boot 中 如 何 使 用 Spring Batch。 





13.3.2 ”整合 Spring Boot 


现在 有 一 个 data.csv 文件 ， 文 件 中 保存 了 4 条 用 户 数据 ， 通 过 批 处 理 框 架 读 取 data.csv， 将 之 
插入 数据 表 中 。 

首先 创建 一 个 Spring Boot Web 工程 ， 并 添加 spring-boot-starter-batch 依赖 以 及 数据 库 相 关 依 
赖 ， 代 码 如 下 : 
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<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-batch</artifactId> 
</dependency> 

<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-jdbc</artifactId> 
</dependency> 

<dependency> 

10 | <groupId>org.springframework.boot</groupId> 

11 | <artifactId>spring-boot-starter-web</artifactId> 
12 | </dependency> 

13 | <dependency> 

14 | <groupId>com.alibaba</groupId> 

15 | <artifactId>druid</artifactId> 

16 | <version>1.1.10</version> 

17 | </dependency> 

18 | <dependency> 

19 | <groupId>mysql</groupId> 

20 | <artifactId>mysql-connector-java</artifactId> 

21 | </dependency> 


如 前 文 所 说 ， 添 加 数据 库 相 关 依赖 是 为 了 将 批 处 理 的 执行 状态 持久 化 到 数据 库 中 。 项 目 创建 
完成 后 ， 在 application.properties 中 进行 数据 库 基 本 信息 配置 : 


spring.datasource.type=com.alibaba.druid.pool.DruidDataSource 
spring.datasource.username=root 
spring.datasource.password=root 
spring.datasource.url=jdbc:mysql:///batch 


oammwmn 











spring.datasource.schema=classpath:/org/springframework/batch/core/schema-mysql.s 
ql 

spring.batch.initialize-schema=always 

spring.batch.job.enabled=false 





前 4 行 配置 是 数据 的 基本 配置 ， 这 里 不 再 袭 述 。 第 5 行 配置 是 项 目 启动 时 创建 数据 表 的 SQL 
脚本 ， 该 脚本 由 Spring Batch 提供 。 第 6 行 配置 表示 在 项 目 启动 时 执行 建 表 SQL。 第 7 行 配置 表示 
禁止 Spring Batch 自动 执行 。 在 Spring Boot 中 ， 默 认 情况 下 ， 当 项 目 启动 时 就 会 执行 配置 好 的 批 
处 理 操作 , 添加 了 第 7 行 的 配置 后 则 不 会 自动 执行 , 而 需要 用 户 手动 触发 执行 , 例如 发 送 一 个 请 求 ， 
在 Controller 的 接口 中 触发 批 处 理 的 执行 。 

接 下 来 在 项 目 启动 类 上 添加 @EnableBatchProcessing 注解 开启 Spring Batch 支持 ， 代 码 如 下 
@Spring BootApplication 

@EnableBatchProcessing 

public class BatchApplication { 


public static void main(String[] args) { 
SpringApplication.run(BatchApplication.class, args); 





ANMioDPp 


} 
接 下 来 配置 批 处 理 ， 代 码 如 下 : 
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10 
11 


@Configuration 
public class CsvBatchJobConfig { 
QAutowired 
JobBuilderFactory jobBuilderFactory; 
QAutowired 
StepBuilderFactory stepBuilderFactory; 
@Autowired 
DataSource dataSource; 
QBean 
QStepScope 
FlatFileItemReader<User> itemReader() { 
FlatFileItemReader<User> reader = new FlatFileItemReader<>() 7 
reader.setLinesToSkip (1) ; 
Teader.setResource (new ClassPathResource ("data.csv")); 
reader.setLineMapper (new DefaultLineMapper<User>(){{ 
setLineTokenizer (new DelimitedLineTokenizer(){{ 
setNames ("id", "username", "address", "gender"); 
setDelimiter ("\t"); 
11); 
setFieldSetMapper (new BeanWrapperFieldSetMapper<User>() {{ 
setTargetType (User.class); 
}}) 7 
})) 7 


return reader; 





} 
QBean 
JdbcBatchItemWriter jdbcBatchItemWriter() { 
JdbcBatchItemWriter writer = new JdbcBatchItemWriter (); 
writer.setDataSource (dataSource); 
writer.setSql ("insert into user (id,username,address,gender) " + 
"values (:id, :username, :address, :gender) "); 
writer.setItemSqlParameterSourceProvider( 
new BeanPropertyItemSqlParameterSourceProvider<>()); 
return writer; 
} 
QBean 
Step csvStep () { 
return stepBuilderFactory.get ("csvStep") 
.<User, User>chunk (2) 
.reader (itemReader ()) 
.writer (jdbcBatchItemWriter ()) 
.build(); 
} 
QBean 
Job csvJob() { 
return jobBuilderFactory.get ("csvJob") 
.start (csvStep()) 
.build(); 
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代码 解释 : 


创建 CsvBatchJobConfig 进行 Spring Batch 配置 ， 同 时 注入 JobBuilderFactory 、 
StepBuilderFactory 以 及 DataSource 备用 ， 其 中 JobBuilderFactory 将 用 来 构建 Job， 
StepBuilderFactory 用 来 构建 Step，DataSource 则 用 来 支持 持久 化 操作 ， 这 里 持久 化 方案 是 
Spring-Jdbc. 

第 9-25 行 配置 一 个 ItemReader，Spring Batch 提供 了 一 些 常用 的 ItemReader， 例 如 
JdbcPagingItemReader 用 来 读 取 数 据 库 中 的 数据 ，StaxEventItemReader 用 来 读 取 XML 数据 ， 
本 案 例 中 的 FlatFileItemReader 则 是 一 个 加 载 普通 文件 的 ItemReader。 在 FlatFileItemReader 
的 配置 过 程 中 , 由 于 data.csv 文件 第 一 行 是 标题 , 因此 通过 setLinesToSkip 方法 设置 跳 过 一 行 ， 
然后 通过 setResource 方法 配置 data.csv 文件 的 位 置 ， 笔 者 的 data.csv 文件 放 在 classpath 目录 
下 ， 然 后 通过 setLineMapper 方法 设置 每 一 行 的 数据 信息 ，setNames 方法 配置 了 data.csv 文 件 
一 共有 4 列 ， 分 别 是 id、usemame、address 以 及 gender，setDelimiter 则 是 配置 列 与 列 之 间 的 
间隔 符 ( 将 通过 间隔 符 对 每 一 行 的 数据 进行 切 分 )， 最 后 设置 要 映射 的 实体 类 属性 即 可 。 

第 26-35 行 配置 temWriter， 即 数据 的 写 出 逻辑 ，Spring Batch 也 提供 了 多 个 ItemWriter 的 实 
现 , 常见 的 如 FlatFileltemWriter， 表 示 将 数据 写 出 为 一 个 普通 文件 ，StaxEventItemWriter 表示 
将 数据 写 出 为 XML. 另外 ,还 有 针对 不 同 数 据 库 提供 的 写 出 操作 支持 类 , 如 MongoItemWiiter、 
JpaltemWriter、Neo4jItemWriter 以 及 HibernateltemWriter 等 , 本 案例 使 用 的 JdbcBatchItemWriter 
则 是 通过 JDBC 将 数据 写 出 到 一 个 关系 型 数据 库 中 。JdbcBatchItemWiriter 主要 配置 数据 以 及 
数据 插入 SQL ， 注 意 占 位 符 的 写法 是 “: 属 性 名 ”。 最 后 通过 
BeanPropertyItemSqlParameterSourceProvider 实例 将 实体 类 的 属性 和 SQL 中 的 占 位 符 一 一 映 
射 。 

第 36-43 行 配置 一 个 Step，Step 通过 stepBuilderFactory 进行 配置 ， 首 先 通过 get 获取 一 个 
StepBuilder， get 方法 的 参数 就 是 该 Step 的 name， 然 后 调用 chunk 方法 的 参数 2， 表 示 每 读 
取 到 两 条 数据 就 执行 一 次 write 操作 ， 最 后 分 别 配置 reader 和 writer。 

第 44~49 行 配置 一 个 Job, 通 过 jobBuilderFactory 构建 一 个 Job, get 方法 的 参数 为 Job 的 name， 
然后 配置 该 Job 的 Step 即 可 。 


当然 ， 这 里 还 涉及 一 个 User 实体 类 ， 代 码 如 下 : 








om wm 


public class User { 


} 


private Integer id; 
private String username; 
private String address; 
private String gender; 
// 省 略 getter/setter 








另外 ，classpath 下 的 data.csv 文件 如 图 13-13 所 示 。 
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六 data.csv 


id usernanme address gender 
1 张 三 深圳 男 
2 里 斯 广州 男 
3 王 五 广州 男 
4 赵 六 北京 刻 





图 13-13 


接 下 来 创建 Controller， 当 用 户 发 起 一 个 请 求 时 触发 批 处 理 ， 代 码 如 下 : 





下 @RestController 

2 public class HelloController { 
3 @Autowired 

4 JobLauncher jobLauncher; 

5 @Autowired 

6 Job job; 

7 @GetMapping ("/hello") 

8 public void hello() { 

9 try { 

10 jobLauncher.run(job, null); 
11 } catch (Exception e) { 
12 e.printSstackTrace (); 





JobLauncher 由 框架 提供 ，Job 则 是 刚刚 配置 的 ， 通 过 调用 JobLauncher 中 的 run 方法 启动 


批 处 理 。 





个 


最 后 根据 上 文 的 实体 类 在 数据 库 中 创建 一 个 user 表 ， 然 后 启动 Spring Boot 工程 并 访问 
http://localhost:8080/hello 接口 ， 访 问 成 功 后 ，batch 库 中 会 自动 创建 出 多 个 批 处 理 相关 的 表 ， 如 图 
13-14 所 示 。 这 些 表 用 来 记录 批 处 理 的 执行 状态 ， 同 时 ，data.csv 中 的 数据 也 已 经 成 功 插入 user 表 


中 ， 如 图 13-15 所 示 。 


《0. 00 





图 13-14 图 13-15 
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13.4 Swagger2 


13.4.1 Swagger 2 简介 


在 前 后 端 分 离开 发 中 ， 为 了 减少 与 其 他 团队 的 沟通 成 本 ， 一 般 构 建 一 份 RESTful API 文档 来 
描述 所 有 的 接口 信息 ， 但 是 这 种 做 法 有 很 大 的 弊端 ， 分 别 说 明 如 下 : 


@ 接口 众多 ， 编 写 RESTful API 文 档 工作 量 巨大 ， 因 为 RESTful API 文 档 不 仅 要 包含 接口 的 基 
本 信息 ， 如 接口 地 址 、 接 口 请 求 参数 以 及 接口 返回 值 等 ， 还 要 包含 HTTP 请 求 类 型 、HTTP 
请 求 头 、 请 求 参数 类 型 、 返 回 值 类 型 、 所 需 权限 等 。 

@ 维护 不 方便 ， 一 旦 接口 发 生变 化 ， 就 要 修改 文档 。 

@ 接口 测试 不 方便 ， 一 般 只 能 借助 第 三 方 工具 (如 Postman ) 来 测试 。 


Swagger 2 是 一 个 开源 软件 框架 ， 可 以 帮助 开发 人 员 设 计 、 构 建 、 记 录 和 使 用 RESTful Web 服 
务 ， 它 将 代码 和 文档 融 为 一 体 ， 可 以 完美 解决 上 面 描述 的 问题 ， 使 开发 人 员 将 大 部 分 精力 集中 到 业 
务 中 ， 而 不 是 繁杂 琐碎 的 文档 中 。 

Swagger 2 可 以 非常 轻松 地 整合 到 Spring Boot 项 目 中 ， 下 面 来 看 如 何 整合 。 


13.4.2 整合 Spring Boot 


首先 创建 Spring Boot Web 项 目 ， 添 加 Swagger 2 相关 依赖 ， 代 码 如 下 : 


<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 
</dependency> 

<dependency> 

<groupId>io.springfox</groupId> 
<artifactId>springfox-swagger2</artifactId> 
<version>2.9.2</version> 

</dependency> 

<dependency> 

<groupId>io.springfox</groupId> 
<artifactId>springfox-swagger-ui</artifactId> 
13 | <version>2.9.2</version> 





cam 必 wm 


Re 


广 户 户 
PN 上品 


14 | </dependency> 


接 下 来 创建 Swagger 2 的 配置 类 ， 代 码 如 下 : 








1 @Configuration 

a @EnableSwagger2 

3 public class SwaggerConfig { 
4 QBean 

, Docket docket() { 
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6 return new Docket (DocumentationType. SWAGGER 2) 

村 .select () 

8 .apis (RequestHandlerSelectors.basePackage ("org.sang.controller")) 
9 .paths (PathSelectors.any ()) 

10 .build() .apiInfo (new ApiInfoBuilder() 

11 .description(" 微 人 事 接口 测试 文档 ") 

12 .contact (new Contact ("江南 一 点 雨 "， 


13 | "https://github.com/lenve", 
14 | "wangsong0210@gmail .com")) 


15 .version ("v1.0") 

16 .title ("API 测试 文档 ") 

17 .license ("Apache2.0") 

18 .licenseUrl ("http://www.apache.org/licenses/LICENSE-2.0") 
好 .build()); 











代码 解释 : 


@ 首先 通过 (@EnableSwagger2 注解 开启 Swagger 2， 然 后 最 主要 的 是 配置 一 个 Docket。 
@ 通过 apis 方法 配置 要 扫描 的 controller 位 置 ， 通 过 paths 方法 配置 路 径 。 
e 在 apiInfo 中 构建 文档 的 基本 信息 ， 例 如 描述 、 联 系 人 人 信息、 版本、 标题 等 。 


Swagger 2 配置 完成 后 ， 接 下 来 就 可 以 开发 接口 了 ， 代 码 如 下 : 











1 @RestController 

2 @Api (tags = "用 户 数据 接口 ") 

3 public class UserController { 

4 @ApiOperation (value = "查询 用 户 "，notes = "根据 id 查询 用 户 ") 
@ApiImplicitParam(paramType = "path",name = "id", 

6 value = "用 户 id", required = true) 

了 @GetMapping ("/user/{id}") 

8 public String getUserById(@PathVariable Integer id) { 

a return "/user/" + id; 

10 } 

11 Q@ApiResponses ({ 

12 @ApiResponse (code = 200,message = "删除 成 功 !") ， 

13 @ApiResponse (code = 500,message = "删除 失败 !") }) 

14 @ApiOperation (value = "删除 用 户 "，notes = "通过 id 删除 用 户 ") 
15 Q@DeleteMapping ("/user/{id}") 

16 public Integer deleteUserById (@PathVariable Integer id) { 
17 return id; 

18 $ 

19 @ApiOperation (value = "添加 用 户 "， 

20 notes = "添加 一 个 用 户 ， 传 入 用 户 名 和 地 址 ") 

21 QApiImplicitParams ({ 

22 QApiImplicitParam (paramType = "query", name = "username", 
23 value = "用 户 名 "，required = true, defaultValue = "sang")， 
24 QApiImplicitParam (paramType = "query", name = "address", 
和 25 value = "用 户 地 址 "，required = true, defaultValue = "shenzhen") }) 
26 QPostMapping ("/user") 
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27 public String addUser (eaRequestParam String username, 
28 @RequestParam String address) { 
9 return username + ":" + address; 

30 } 

31 @ApiOperation (value = "修改 用 户 "，notes = "修改 用 户 ， 传 入 用 户 信息 ") 
2 Q@PutMapping ("/user") 

33 public String updateUser (@RequestBody User user) { 
34 return user.tostring(); 

35 } 

36 | @GetMapping ("/ignore") 

37 | @ApiIgnore 

38 | public void ingoreMethod() { 

39 | } 

40 | } 

41 | eapiModel (value = "用 户 实体 类 ",description = "用 户 信息 描述 类 ") 
42 | public class User { 

43 @ApiModelProperty (value = "用 户 名 ") 

44 private String username; 

45 @ApiModelProperty (value = "用 户 地 址 ") 

46 private String address; 

47 // 省 略 getter/setter 

48 | } 











代码 解释 : 


。 @Api 注解 用 在 类 上 ， 用 来 描述 整个 Controller 信息 。 

。 (@ApiOperation 注解 用 在 开发 方法 上 ， 用 来 描述 一 个 方法 的 基本 信息 ，value 是 对 方法 作用 的 
一 个 简短 描述 ，notes 则 用 来 备注 该 方法 的 详细 作用 。 

。 (@ApilmplicitParam 注解 用 在 方法 上 , 用 来 描述 方法 的 参数 , paramType 是 指 方法 参数 的 类 型 ， 
可 选 值 有 path ( 参数 获取 方式 @PathVariable )、query ( 参数 获取 方式 @RequestParam )、header 

(参数 获取 方式 Q@RequestHeader )、body 以 及 form; name 表示 参数 名 称 ， 和 参数 变量 对 应 ; 

value 是 参数 的 描述 信息 ; required 表示 该 字段 是 否 必 填 ; defaultValue 表示 该 字段 的 默认 值 。 
注意 ， 这 里 的 required 和 defaultValue 等 字段 只 是 文档 上 的 约束 描述 ， 并 不 能 真正 约束 接口 ， 
约束 接口 还 需要 在 @RequestParam 中 添加 相关 属性 。 
如 果 方 法 有 多 个 参数 ,可 以 将 多 个 参数 的 @ApiImplicitParam 注解 放 到 @ApilmplicitParams 中 。 

ee (@ApiResponse 注解 是 对 响应 结果 的 描述 ，code 表示 响应 码 ，message 表示 相应 的 描述 信息 ， 
若 有 多 个 @ApiResponse， 则 放 在 一 个 @ApiResponses 中 。 

ee 在 updateUser 方法 中 ， 使 用 @RequestBody 注解 来 接收 数据 ， 此 时 可 以 通过 @ApiModel 注解 
和 (@ApiModelProperty 注解 配置 User 对 象 的 描述 信息 。 

。 (@Apilgnore 注解 表示 不 对 某 个 接口 生成 文档 。 


接 下 来 启动 Spring Boot 项 目 ， 在 浏览 器 中 输入 http://localhost:8080/swagger-ui.html 即 可 看 到 


接口 文档 ， 如 图 13-16 所 示 。 





第 13 章 企业 开发 


| 5 








{] Swagger 


:2080N2/apE 
微 人 可 接口 测试 文档 


了 南 一 启 坪 -Webskte 
5end emall to 江南 一点 盏 


Apache20 


Models 


API 测 试 文档 品 


用 户 数据 接口 user controler 


所 CG 合 |@ localhost8080/swagger-uihtml#/ 


图 13-16 





展开 用 户 数据 接口 ， 即 可 看 到 所 有 接口 的 描述 ， 如 图 13-17 所 示 。 


展开 一 个 








用 户 数 据 接口 user controler 


接口 描述 ， 内 容 如 图 13-18 所 示 ， 单 击 Try it out 按钮 ， 可 以 实现 对 该 接 

















本 








本 








| | /user/{1d】 查询 用 户 








/user/{fid} 删除 用 户 




















图 13-17 
[ee 

添加 一 个 用 户 ， 传 入 用 户 名 和 地 址 
Name Description 
address :required 

用 户 地 址 
string 

(qvery) Default value: shenzhen 
Usarname * equired 
String 二 

{query) Default value: sang 
a | 

















图 13-18 


的 测试 。 
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13.5 数据 校 验 











数据 校 验 是 开发 过 程 中 一 个 常见 的 环节 ， 一 般 来 说 ， 为 了 提高 系统 运行 效率 ， 都 会 在 前 端 进 
行 数据 校 验 , 但 是 这 并 不 意味 着 不 必 在 后 端 做 数据 校 验 了 , 因为 用 户 还 是 可 能 在 获取 数据 接口 后 
动 传 入 非法 数据 ， 所 以 后 端 还 是 需要 做 数据 校 验 。Spring Boot 对 此 也 提供 了 相关 的 自动 化 配置 解 
决 方案 ， 下 面 分 别 予 以 介绍 。 








m 

















13.5.1 普通 校 验 


普通 校 验 是 基础 用 法 ， 非 常 容易 ， 首 先 需要 用 户 在 Spring Boot Web 项 目 中 添加 数据 校 验 相 关 
的 依赖 ， 代 码 如 下 : 


<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-validation</artifactId> 
</dependency> 


<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 
</dependency> 


项 目 创建 成 功 后 ， 查 看 LocalValidatorFactoryBean 类 的 源码 ， 发 现 默认 的 
ValidationMessageSource〈 校 验 出 错时 的 提示 文件 ) 是 resources 目录 下 的 ValidationMessages. 
properties 文件 ， 因 此 在 resources 目录 下 创建 ValidationMessages.properties 文件 ， 内 容 如 下 〈 如 果 
文件 出 现 乱 码 ， 参 考 2.6 节 解 决 ) : 
user.name. size= 用 户 名 长 度 介 于 5 到 10 个 字符 之 间 
user.address.notnul1= 用 户 地 址 不 能 为 空 
user.age.size= 年 龄 输入 不 正确 


user.email.notnul1= 邮 箱 不 能 为 空 
user.email.pattern= 邮 箱 格式 不 正确 


接 下 来 创建 User 类 ， 配 置 数据 校 验 ， 代 码 如 下 : 


oONMAoODpp 





an 必 wb 








入 public class User { 

2 private Integer id; 

本 Size (min = 5, max = 10, message = "{user.name.size}") 
4 private String name; 

5 @NotNull (message = "{user.address.notnull}") 

6 private String address; 

7 Q@DecimalMin (value = "1", message = "{user.age.size}") 

8 QDecimalMax (value = "200", message = "{user.age.size}") 
9 private Integer age; 

10 QEmail (message = "{user.email .pattern}") 








人 Q@NotNull (message = "{user.email.notnull}") 
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12 Private String email; 
13 // 省 上 getter/setter 
14 | } 
代码 解释 : 
ee @Size 表示 一 个 字符 串 的 长 度 或 者 一 个 集合 的 大 小 ， 必 须 在 某 一 个 范围 中 ; min 参数 表示 范 
围 的 下 限 ; max 参数 表示 范围 的 上 限 ; message 表示 校 验 失 败 时 的 提示 信息 。 
ee @NotNull 注解 表示 该 字段 不 能 为 空 。 
ee (@DecimalMin 注解 表示 对 应 属性 值 的 下 限 ，(@DecimalMax 注解 表示 对 应 属性 值 的 上 限 。 
。 @Email 注解 表示 对 应 属性 格式 是 一 个 Email。 
配置 完成 后 ， 接 下 来 创建 UserController， 代 码 如 下 : 
L @RestController 
2 | public class UserController { 
3 @PostMapping ("/user") 
4 public List<String> addUser (eValidated User user, BindingResult result) { 
5 List<String> errors = new ArrayList<>(); 
6 if (result.hasErrors()) { 
7 List<ObjectError> allErrors = result.getAllErrors(); 
8 for (ObjectError error : allErrors) { 
9 errors.add (error.getDefaultMessage ()); 
10 } 
11 } 
12 return errors; 








代码 解释 : 

e@ 给 User 参数 添加 @Validated 注解 ， 表 示 需 要 对 该 参数 做 校 验 ， 紧 接着 的 BindingResult 参数 
表示 在 校 验 出 错时 保存 的 出 错 信息 。 

@ 如果 BindingResult 中 的 hasEmors 方法 返回 tue， 表 示 有 错误 信息 ， 此 时 遍历 错误 信息 ， 将 之 
返回 给 前 端 。 


配置 完成 后 ， 接 下 来 使 用 Postman 进行 测试 ， 例 如 直接 访问 “/user” 接 口 ， 结 果 如 图 13-19 所 示 。 











图 13-19 


如 果 传 入 用 户 地 址 、 一 个 非法 邮箱 地 址 以 及 一 个 格式 不 正确 的 用 户 名 ， 结 果 如 图 13-20 所 示 。 
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POST * herp:/Wlocalhosr 深圳 &name= 张 三 








Prerty JsoN ”也 
a 
2 邮箱 格式 不 正确 "， 本 
用 户 名 长 度 介 于 5 到 16 个 字符 之 间 ” 
4 1 
图 13-20 


13.5.2 分 组 校 验 


有 的 时 候 ， 开 发 者 在 某 一 个 实体 类 中 定义 了 很 多 校 验 规则 ， 但 是 在 某 一 次 业务 处 理 中 ， 并 不 
需要 这 么 多 校 验 规则 ， 此 时 就 可 以 使 用 分 组 校 验 。 分 组 校 验 步骤 如 下 ; 
首先 创建 两 个 分 组 接口 ， 代 码 如 下 : 


public interface ValidationGroupl { 
} 
public interface ValidationGroup2 { 


} 
然后 在 实体 类 中 添加 分 组 信息 ， 代 码 如 下 : 


public class User { 
private Integer id; 
QSize(min = 5, max = 10, message = "{user.name.size}", 
groups = ValidationGroupl .class) 
private String name; 
@NotNull (message = "{user.address.notnull}", groups = ValidationGroup2.class) 
private String address; 
@DecimalMin (value = , message = "{user.age.size}") 
Q@DecimalMax (value = "200", message = "{user.age.size}") 
private Integer age; 
Q@Email (message = "{user.email.pattern}") 
@NotNull (message = "{user.email.notnull}", 
groups = {ValidationGroupl.class,ValidationGroup2.class}) 
private String email; 
// 省 上 getter/setter 




















这 次 在 部 分 注解 中 添加 了 groups 属性 ， 表 示 该 校 验 规则 所 属 的 分 组 ， 接 下 来 在 @Validated 注 
解 中 指定 校 验 分 组 ， 代 码 如 下 : 


@RestController 
public class UserController { 
QPostMapping ("/user" 
public List<String> addUser (@Validated (ValidationGroup2.class) User user, 
BindingResult result) { 
List<String> errors = new ArrayList<>(); 











1 
2 
3 
4 
5 
6 
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15 1} 


if (result.hasErrors()) { 
List<ObjectError> allErrors = result.getAllErrors(); 
for (ObjectError error : allErrors) { 
errors.add (error.getDefaultMessage ()); 
} 
} 


return errors; 








@Validated(ValidationGroup2.class) 表 示 这 里 的 校 验 使 用 ValidationGroup2 分 组 的 校 验 规则 , 即 
只 校 验 邮 箱 地 址 是 否 为 室 、 用 户 地 址 是 否 为 空 。 测 试 案例 如 图 13-21 所 示 。 在 图 13-21 的 测试 案例 
中 ， 虽 然 邮 箱 地 址 格式 不 正确 ，name 长 度 也 不 满足 要 求 ， 但 是 这 些 都 不 属于 ValidationGroup2 校 
给 分 组 的 校 验 规则 ， 这 里 只 校 验 邮箱 地 址 是 否 为 空 、 用 户 地 址 是 否 为 空 。 


hrrp//localhosc8080/user?email=123&name= 张 三 


"用户 地 址 不 能 为 空 





图 13-21 


13.5.3” 校 验 注解 


前 面向 读者 介绍 了 几 个 常见 的 校 验 注解 ， 实 际 上 校 验 注解 不 止 前 面 提 到 的 几 个 ， 完 整 的 校 验 
注解 可 参考 表 13-1。 


表 13-1 校 验 注解 




















校 验 注解 注解 的 元 素 类 型 描述 

AssertFalse 被 注解 的 元 素 值 必须 为 false 

AssertTrue 被 注解 的 元 素 值 必须 为 tue 

ed BigDecimal、BigInteger、CharSequence、byte、| 被 注解 的 元 素 值 小 于 等 于 @ 
short、int、long 以 及 它们 各 自 的 包装 类 DecimalMax 注解 中 的 value 值 

i BigDecimal、BigInteger、CharSequence、byte、| 被 注解 的 元 素 值 大 于 等 于 @ 
short、int、long 以 及 它们 各 自 的 包装 类 DecimalMin 注解 中 的 value 值 

ee BigDecimal、BigInteger、byte、short、 int、 | 被 注解 的 元 素 值 小 于 等 于 @ Max 注 
long 以 及 它们 各 自 的 包装 类 解 中 的 value 值 

ji BigDecimal、BigInteger、byte、short、 int、 | 被 注解 的 元 素 值 大 于 等 于 @ Min 注解 
long 以 及 它们 各 自 的 包装 类 中 的 value 值 

被 注解 的 元 素 必 须 是 一 个 数字 ， 其 值 
Digits BigDecimal、 Biginteger、CharSequence、byte、| 必须 在 可 接受 的 范围 内 《整数 位 数 和 





、int、long 以 及 它们 各 自 的 
short、int、long 以 及 它们 各 自 的 包装 类 小 数位 数 在 指定 范围 内 ) 
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( 续 表 ) 
校 验 注解 注解 的 元 素 类 型 描述 
Email 被 注解 的 元 素 值 必须 是 Email 格式 
a java.util.Date、java.util.Calendar 以 及 javatime | 被 注解 的 元 素 值 必须 是 一 个 未 来 的 日 
€ 
包 下 的 时 间 类 期 
a. java.util.Date、java.util.Calendar 以 及 java.time | 被 注解 的 元 素 值 必须 是 一 个 过 去 的 日 
as 
包 下 的 时 间 类 期 
be java.util.Date、java.util.Calendar 以 及 java.time | 被 注解 的 元 素 值 必须 是 一 个 过 去 的 日 
Pe 包 下 的 时 间 类 期 或 者 当前 日 其 
nt java.util.Date、java.util.Calendar 以 及 java.time | 被 注解 的 元 素 值 必须 是 一 个 未 来 的 日 
包 下 的 时 间 类 期 或 当前 日 其 
. BigDecimal、 BigInteger、 byte、 short、 int、| ，、 a 
注解 的 元 素 必 须 是 负 
Negative long 以 及 它们 各 自 的 包装 类 被 注解 的 元 素 必须 是 负数 
. BigDecimal、BigInteger、byte、 De 
Zer 注解 的 元 素 必须 是 负数 
a long 以 及 它们 各 自 的 包装 类 和 
2 BigDecimal、BigInteger、byte、 ne 
注解 的 元 素 必须 是 正 
Positive long 以 及 它们 各 自 的 包装 类 被 注解 的 元 素 必 须 是 正 数 
本 BigDecimal、BigInteger、byte、 Sy Ep 本 
注解 的 元 素 必须 是 正 数 避 
PositiveOrZero long 以 及 它们 各 自 的 包装 类 被 注解 的 元 素 必须 是 正 数 或 0 
被 注解 的 元 素 必须 不 为 null 并 且 至 少 
sa 有 一 个 非 空白 的 字符 
被 注解 的 字符 串 不 为 null 或 空 字符 
串 ， 被 注解 的 集合 或 数组 不 为 室 。 和 
NotEmpty CharSequence、Collection、Map、Array @ NotBlank 注解 相 比 ,一 个 空格 字符 
串 在 @ NotBlank 验证 不 通过 , 但 是 在 
@ NotEmpty 中 验证 通过 
NotNull 任意 类 型 被 注解 的 元 素 不 为 pull 
Null 任意 类 型 被 注解 的 元 素 为 null 
被 》 元 素 必须 符合 指定 
达 式 
被 注解 的 字符 串 长 度 、 集 合 或 者 数 纪 
Size CharSequence、Collection、Map、Array 被 注解 的 字符 喇 长 用、 夺 合 或 而 儿 组 


的 大 小 必须 在 指定 范围 内 








13.6 小 结 


本 章 向 读者 介绍 了 企业 开发 中 一 些 常用 的 功能 ， 如 邮件 发 送 、 定 时 任务 、 批 处 理 、Swagger 2 
以 及 数据 校 验 ， 这 些 功能 都 有 非常 广泛 的 使 用 场景 ， 如 用 户 注册 、 修 改 密码 、 定 时 备份 、 接 口 文档 
等 ， 除 了 Swagger 2 外 ， 其 他 4 个 功能 在 Spring Boot 中 都 提供 了 相关 的 Starter， 简 化 了 开发 者 的 
使 用 步 又， 提高 了 开发 效率 。 




















本 章 概要 


。 监控 端点 配置 
。 监控 信息 可 视 化 
。 邮件 报警 


当 一 个 Spring Boot 项 目 运行 时 ， 开 发 者 需要 对 Spring Boot 项 目 进行 实时 监控 ,获取 项 目的 运 
行情 况 ， 在 项 目 出 错时 能 够 实现 自动 报警 等 。Spring Boot 提供 了 actuator 来 帮助 开发 者 获取 应 用 
程序 的 实时 运行 数据 。 开 发 者 可 以 选择 使 用 HITP 端点 或 JMX 来 管理 和 监控 应 用 程序 ， 获 取 应 用 
程序 的 运行 数据 ， 包 括 健康 状况 、 应 用 信息 、 内 存 使 用 情况 等 。 


14.1 端点 配置 


14.1.1 开启 端点 


在 Spring Boot 中 开启 应 用 监控 非常 容易 ， 只 需要 添加 spring-boot-starter-actuator 依赖 即 可 ， 
actuator 〈 执 行 器 ) 是 制造 业 术 语 ， 指 一 个 用 于 移动 或 控制 机 械 装置 的 工具 ， 一 个 很 小 的 变化 就 能 
让 执行 器 产生 大 量 的 运动 。 依 赖 如 下 : 

1 [<dependency> 


2 <groupId>org.springframework.boot</groupId> 
3 <artifactId>spring-boot-starter-actuator</artifactId> 
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4 | <yadependency> 








开发 者 可 以 使 用 执行 器 中 的 端点 (EndPoints) 对 应 用 进行 监控 或 者 与 应 用 进行 交互 ，Spring 
Boot 默认 包含 许多 端点 ， 如 表 14-1 所 示 。 


表 14-1 Spring Boot 默认 包含 的 端点 












































端点 端点 描述 是 否 开启 
auditevents 展示 当前 应 用 程序 的 审计 事件 信息 Yes 
beans 展示 所 有 Spring Beans 信息 Yes 
di 展示 一 个 自动 配置 类 的 使 用 报告 , 该 报告 展示 所 有 自动 配置 类 及 它们 a 
被 使 用 或 未 被 使 用 的 原因 
configprops 展示 所 有 @ConfigurationProperties 的 列表 Yes 
eny 展示 系统 运行 环境 信息 Yes 
flyway 展示 数据 库 迁 移 路 径 Yes 
health 展示 应 用 程序 的 健康 信息 Yes 
httptrace 展示 trace 信息 (默认 为 最 新 的 100 条 HTTP 请 求 ) Yes 
info 展示 应 用 的 定制 信息 ， 这 些 定制 信息 以 info 开头 Yes 
loggers 展示 并 修改 应 用 的 日 志 配 置 Yes 
liquibase 展示 任何 Liquibase 数据 库 迁 移 路 径 Yes 
metrics 展示 应 用 程序 度量 信息 Yes 
mappings 展示 所 有 @RequestMapping 路 径 的 集合 列表 Yes 
scheduledtasks 展示 应 用 的 所 有 定时 任务 Yes 
shutdown 远程 关闭 应 用 接口 No 
sessions 展示 并 操作 Spring Session 会 话 Yes 
threaddump 展示 线程 活动 的 快照 Yes 
如 果 是 一 个 Web 应 用 ， 还 会 有 表 14-2 所 示 的 端点 。 
表 14-2 Web 应 用 另外 包含 的 端点 
端点 端点 描述 是 否 开启 
heapdump 返回 一 个 GZip 压缩 的 hprof 堆 转 储 文件 Yes 
jolokia 展示 通过 HTTP 暴露 的 JMX beans Yes 
logfile 返回 日 志文 件 内 容 Yes 
prometheus 展示 一 个 可 以 被 Prometheus 服务 器 抓 取 的 metrics 数据 Yes 





这 些 端 点 大 部 分 都 是 默认 开启 的 ， 只 有 shutdown 端点 默认 未 开启 ， 如 果 需 要 开启 ， 可 以 在 
application.properties 中 通过 如 下 配置 开启 : 





全 management .endpoint.shutdown.enabled=true 


如 果 开 发 者 不 想 暴露 这 么 多 端点 ， 那 么 可 以 关闭 默认 的 配置 ， 然 后 手动 指定 需要 开启 哪些 端 
点 ， 如 下 配置 表示 关闭 所 有 端点 ， 只 开启 info 端点 : 








management .endpoints.enabled-by-default=false 
过 management .endpoint .info.enabled=true 
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14.1.2 ”暴露 端点 


由 于 有 的 端点 包含 敏感 信息 ， 因 此 端点 启用 和 暴露 是 两 码 事 。 表 14-3 展示 了 端点 的 默认 暴露 
情况 。 








表 14-3 端点 的 默认 暴露 情况 


























端点 JMX Web 
auditevents Yes No 
beans Yes No 
conditions Yes No 
configprops Yes No 
enV ‘Yes No 
flyway Yes No 
health Yes Yes 
httptrace Yes No 
info Yes Yes 
loggers Yes No 
liquibase Yes No 
metrics Yes No 
mappings Yes No 
scheduledtasks Yes No 
shutdown Yes No 
Sessions Yes No 
threaddump Yes No 
heapdump N/A No 
jolokia N/A No 
logfile N/A No 
prometheus N/A No 


在 Web 应 用 中 , 默认 只 有 health 和 info 两 个 端点 暴露 , 即 当 开发 者 在 Spring Boot 项 目 中 加 入 
spring-boot-starter-actuator 依赖 并 启动 Spring Boot 项 目 后 ， 默 认 只 有 这 两 个 端口 可 访问 ， 启 动 日 志 
如 图 14-1 所 示 。 





main] s.b.a.e.w.s.WebllvcEndpointHandlerllapping : Mapped “ {[/actuator/health],methods=[GET], produces= 
main] s.b.a.e.w.s.WebllvcEndpointHandlerMapping : Mapped “ {[/actuator/info],methods=[GET], produces=[al 





main] s.b.a.e.w.s.WebllvcEndpointHandlerlapping : Mapped “ {[/actuator], methods=[GET], produces=[applic 





图 14-1 


开发 者 可 以 在 配置 文件 中 自 定义 需要 暴露 哪些 端点 ,例如 要 暴露 mappings 和 metrics 端点 , 添 
加 如 下 配置 即 可 : 


和 | management .endpoints .web.exposure.include=mappings,metrics 


如 果 要 暴露 所 有 端点 ， 添 加 如 下 配置 即 可 : 
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业 | management .endpoints .web.exposure.include=* 





由 于 * 在 YAML 格式 的 配置 文件 中 有 特殊 的 含义 ， 因 此 如 果 在 YAML 中 配置 暴露 所 有 端点 ， 











让 management : 

当 endpoints: 

3 web: 

4 exposure: 

入 include: "*" 





当 配置 暴露 所 有 端点 后 ， 启 动 日 志 如 图 14-2 所 示 。 


s.b.a.e.w.s.WebllvcEndpointHandlerlMapping : Mapped “ {[/actuator/auditevents],methods=[GET], produ 
s.b. a. e.w, s.WeblfvcEndpointHandlerlfapping : Mapped “ {[/actuator/beans], methods=[GET], produces=[al 
s.b.a.e.w.s.WeblivcEndpointHandlerllapping : Mapped “ {[/actuator/health], methods=[GET], produces=[: 
s.b.a.e.w.s.WebllvcEndpointHandlerllapping : Mapped “ {[/actuator/conditions], methods=[GET], produc 
s.b.a.e,.w,s,.WeblivcEndpointHandlerMapping : Mapped “ {[/actuator/configprops], methods=[GET], produ 


. s. WebllvcEndpointHandlerMapping : Mapped “{[/actuator/env],methods=[GET], produces=[app 
, s. WebllvcEndpointHandlerMapping : Mapped “ {[/actuator/env/{tollatch}], methods=[GET], pro 
, s. WebllvcEndpointHandlerlMapping : Mapped “ {[/actuator/info],methods=[GET], produces=[ap 


. s. WeblivcEndpointHandlerllapping : Mapped “ {[/actuator/loggers], methods=[GET], produces= 


. s. WebllvcEndpointHandlerMapping : Mapped “{[/actuator/loggers/ {name}],methods=[GET], pr 








和 
[4 
习 有 如 恒 肝 有 有 叶 革 车 


s. . s. WebllvcEndpointHandlerMapping : Mapped “{[/actuator/loggers/ {name}],methods=[POST],¢ 
s.b.a.e.w.s.WebllvcEndpointHandlerllapping : Mapped “ {[/actuator/heapdump], methods=[GET], produces: 
s.b.a.e.w,s.WeblivcEndpointHandlerlapping : Mapped “ {[/actuator/threaddump], methods=[GET], produc' 
s.b. a.e.w.s.WeblivcEndpointHandlerllapping : Mapped “ {[/actuator/metrics/{requiredlletriclName}], me 
s.b, a. e,w. s.WeblfvcEgndpointHandlerlfapping : Mapped “ {[/actuator/metrics], methods=[GET], produces= 
s.b.a.e.w.s.WeblivcEndpointHandlerllapping : Mapped “ {[/actuator/scheduledtasks], methods=[GET], pr 


w.s. WebllvcEndpointHandlerllapping : Mapped “ {[/actuator/httptrace], methods=[GET], produce 
, a, e. w, s. WeblivcEndpointHandlerMapping : lapped “ {[/actuator/nappings], methods=[GET], produces: 
W 








, s. WebllvcEndpointHandlerlMapping : Mapped “ {[/actuator],methods=[GET], produces=[applicat 


图 14-2 


此 时 读者 发 现 ， 并 非 所 有 的 端点 都 在 启动 日 志 中 展示 出 来 了 ， 这 是 因为 部 分 端点 需要 相关 依 
赖 才能 使 用 , 例如 sessions 端点 需要 spring-session 依赖 。 对 于 已 经 展示 出 来 的 接口 , 开发 者 可 以 直 
接 发 送 相应 的 请 求 查看 相关 信息 ， 例 如 请 求 health 端点 ， 如 图 14-3 所 示 。"status":"up" 表 示 应 用 在 
线 ， 默 认 展 示 的 health 信息 较 少 ， 后 面 会 详细 介绍 health 端点 的 其 他 配置 。 


/llocalhost:8080/actuator/health 


"status": “UP” 








图 14-3 
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14.1.3 ”端点 保护 





如 果 这 些 端 点 需要 对 外 提供 服务 ， 那 么 最 好 能 够 将 这 些 端点 保护 起 来 ， 若 classpath 中 存在 
Spring Security， 则 默认 使 用 Spring Security 保护 ， 使 用 Spring Security 保护 的 步骤 很 简单 ， 首 先 添 
加 Spring Security 依赖 : 





<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-security</artifactId> 


ODP 


</dependency> 





然后 添加 Spring Security 配置 ， 代 码 如 下 : 





@Configuration 
public class ActuatorSecurity extends WebSecurityConfigurerAdapter { 
QOverride 
protected void configure (HttpSecurity http) throws Exception { 
http.requestMatcher (EndpointRequest .toAnyEndpoint ()) 
.authorizeRequests () 
.anyRequest () .hasRole ("ADMIN") 
.and () 
.httpBasic (); 








FFPiDoeDmnamcmwm 





在 HttpSecurity 中 配置 所 有 的 Endpoint 都 需要 具有 ADMIN 角色 才能 访问 , 同时 开启 HttpBasic 





认证 。 注意 ,EndpointRequesttoAnyEndpoint0 表 示 匹 配 所 有 的 Endpoint， 例 如 shutdown、mappings、 


health 等 ， 但 是 不 包括 开发 者 通过 @RequestMapping 注解 定义 的 接口 (关于 Spring Security 的 更 多 
信息 ， 可 以 参考 第 10 章 ) 。 

这 里 为 了 演示 方便 ，Spring Security 就 不 连接 数据 库 了 ,直接 在 application.properties 中 定义 一 
个 用 户 进行 测试 ， 代 码 如 下 : 






spring.security.user.name=sang 
spring.security.user.password=123 
spring.security.user.roles=ADMIN 


定义 完成 后 ， 启 动 Spring Boot 项 目 ， 青 去 访问 health 端点 ， 需 要 登录 后 才 可 以 访问 。 








14.1.4 ”端点 响应 缓存 


对 于 一 些 不 带 参数 的 端点 请 求 会 自动 进行 缓存 ， 开 发 者 可 通过 如 下 方式 配置 缓存 时 间 : 
1 | managenent .endpoint .beans.cache.time-to-live=100s 

这 个 配置 表示 beans 端点 的 缓存 时 间 为 100s， 如 果 要 配置 其 他 端点 ， 只 需 将 beans 修改 为 其 他 
端点 名 称 即 可 。 注 意 ， 如 果 端 点 添加 了 Spring Security 保护 ， 此 时 Principal 会 被 视 为 端点 的 输入 ， 
因此 端点 响应 将 不 被 缓存 。 
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14.1.5 ”路径 映射 


默认 情况 下 ， 所 有 端点 都 暴露 在 “/actuator ”路 径 下 ， 例 如 health 端点 的 访问 路 径 是 
“/actuatorhealth ”， 如 果 开 发 者 需要 对 端点 路 径 进行 定制 ， 可 通过 如 下 配置 进行 ; 


1 management .endpoints.web.base-path=/ 
4 management .endpoints .web.path-mapping.health=healthcheck 


第 一 行 配置 表示 将 “/actuator ”修改 为 “/”, 这 行 配 置 会 使 所 有 的 端点 访问 路 径 失 去 “/actuator” 
前 级 ;第 二 行 配置 表示 将 “health ”修改 为 “healthcheck”， 修 改 后 health 端点 的 访问 路 径 由 
“/actuator/health” 变 为 “/healthcheck”。 此 时 启动 项 目 ， 启 动 日 志 如 图 14-4 所 示 。 




















s.b.a.e.w.s.WebllvcEndpointHandlerllapping : Mapped “{[/auditevents], methods=[GET], produces=[ap) 


s.b.a.e.w.s.WeblvcEndpointHandlerllapping : Mapped “ {[/beans], methods=[ roduces=[applicat 








s.b. a.e.w.s.WebllvcEndpointHandlerllapping : Mapped ethods=[GET], rd 








s.b.a.e.w.s.WebllvcEndpointHandlerllapping : Mapped “ {[/conditions], methods=[GET], produces=[app 
s.b.a.e.w.s.WebllvcEndpointHandlerlapping : Mapped “ {[/configprops], methods=[( produces=[ap 
s.b. a.e.w.s.WebllvcEndpointHandlerllapping : Mapped “{[/env],methods=[GET], produces=[applicatiol 
s.b.a.e.w.s.WebllvcEndpointHandlerMapping : Mapped “ {[/env/{tollatch}], methods=[GET], produces=[ 


s.b. a.e.w. s,WebllvcEndpointHandlerllapping : Mapped “ {[/info], methods=[GET], produces=[applicati 
s.b.a.e.w.s.WebllvcEndpointHandlerlapping : Mapped “ {[/loggers],methods=[GET], produces=[applic 
s.b, a. e.w,s, WeblivcEndpointHandlerlMapping : Mapped * {[/loggers/{name}], methods=[GET], produces= 
s.b.a.e.w.s.WeblivcEndpointHandlerlapping : lapped “ {[/loggers/{name}], methods=[POST], consumesj 





s.b.a.e.w.s.WebllvcEndpointHandlerlapping : Mapped “ {[/heapdump], methods=[GET], produces=[appli 
s.b.a.e.w.s.WebllvcEndpointHandlerMapping : Mapped “ {[/threaddump], methods=[GET], produces=[app 
sb.a.e.w.s, WebllvcEndpointHandlerlMapping : Mapped“{[/metrics/{requiredletricName] ],methods=[g 
s.b. a.e.w.s.WebllvcEndpointHandlerllapping : Mapped “ {[/metrics], methods=[GET], produces=[applic 
s.b.a. e.w.s.WeblivcEndpointHandlerlapping : Mapped “ {[/scheduledtasks], methods=[GET], produces= 





s.b. a.e.w.s,WebllvcEndpointHandlerllapping : Mapped“{[/httptrace]j,methods=[ 





T],produces=[appl 





s.b. a.e.w.s.WebllvcEndpointHandlerllapping : lapped“{[/mappings]j,methods=[GET],produces=[appli 





图 14-4 


14.1.6 CORS 支持 


关于 CORS 的 介绍 ， 读 者 可 以 参考 4.6 节 。 
所 有 端点 默认 都 没有 开启 跨 域 ， 开 发 者 可 以 通过 如 下 配置 快速 开启 CORS 支持 ， 进 而 实现 跨 
域 : 





management .endpoints.web.cors.allowed-origins=http://localhost:8081 
management .endpoints .web.cors.allowed-methods=GET, POST 





这 个 配置 表示 人 允许 端点 处 理 来 自 http://localhost:8081 地 址 的 请 求 ， 允 许 的 请 求 方法 为 GET 和 
POST。 
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14.1.7 ”健康 信息 


1. 展示 健康 信息 详情 
开发 者 可 以 通过 查看 健康 信息 来 获取 应 用 的 运行 数据 ， 进 而 提早 发 现 应 用 问题 ， 提 早 解决 ， 
避免 造成 损失 。 默 认 情况 下 ， 开 发 者 只 能 获取 到 status 信息 〈 见 图 14-3) ， 这 是 因为 detail 信息 默 
认 不 显示 ， 开 发 者 可 以 通过 management.endpoint.health.show-details 属性 来 配置 detail 信息 的 显示 
策略 ， 该 属性 的 取 值 一 共有 三 种 : 
@ never 即 不 显示 details 信息 ， 默 认 即 此 。 
。 when-authorized details 信息 只 展示 给 认证 用 户 ， 即 用 户 登 录 后 可 以 查看 details 信息 ， 未 登 
录 则 不 能 查看 ， 另 外 还 可 以 通过 managementendpointhealth roles 属性 配置 要 求 的 角色 ， 如 果 
不 配置 ， 那 么 通过 认证 的 用 户 都 可 以 查看 details 信息 ， 如 果 配 置 了 ， 例 如 management. 
endpointhealth roles=ADMIN 表示 认证 的 用 户 必须 具有 ADMIN 角色 才能 查看 details 信息 。 
@ always 将 details 信息 展示 给 所 有 用 户 。 


例如 ， 在 pomxml 文件 中 引入 Spring Security 后 ， 在 application.properties 文件 中 增加 如 下 配置 : 


management .endpoints.web.exposure.include=* 
management .endpoint .health.show-details=when_authorized 
management .endpoint .health.roles=ADMIN 


spring.security.user.name=sang 
spring.security.user.password=123 
pring.security.user.roles=ADMIN 





这 里 首先 暴露 所 有 的 端点 ， 配 置 health 的 details 信息 只 展示 给 认证 用 户 ， 并 且 认 证 用 户 还 要 
具有 ADMIN 角色 ,然后 配置 一 个 默认 的 用 户 ,用 户 名 是 sang, 用 户 密码 是 123, 用 户 角色 是 ADMIN。 
配置 完成 后 ， 启 动 Spring Boot 项 目 ， 在 Postman 中 访问 health 端点 ， 如 图 14-5 所 示 。 


lest Learn more about authorization 





Body 名 (10) Status: 200 OK Time: 620 md 





: 136312778752, 
: 136881945688,， 
"threshold": 18485768 








图 14-5 
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2. 健康 指示 器 


Spring Boot 会 根据 classpath 中 依赖 的 添加 情况 来 自动 配置 一 些 HealthIndicators， 如 表 14-4 所 























示 。 
表 14-4 自动 配置 的 Healthlndicators 

名 字 描述 
CassandraHealthIndicator 检查 Cassandra 数据 库 状 况 
DiskSpaceHealthIndicator 低 磁盘 空间 检查 
DataSourceHealthIndicator 检查 是 否 可 以 从 DataSource 获取 一 个 Connection 
ElasticsearchHealthIndicator 检查 Elasticsearch 集群 状况 
InfluxDbHealthIndicator 检查 InfluxDB 状况 
JmsHealthIndicator 检查 JMS 消息 代理 状况 
MailHealthIndicator 检查 邮件 服务 器 状况 
MongoHealthIndicator 检查 MongDB 数据 库 状 况 
Neo4jHealthIndicator 检查 Neo4j 服务 器 状况 
RabbitHealthIndicator 检查 Rabbit 服务 器 状况 
RedisHealthIndicator 检查 Redis 服务 器 状况 
SolrHealthIndicator 检查 Solr 服务 器 状况 











如 果 项 目 中 存在 相关 的 依赖 ， 那 么 列表 中 对 应 的 HealthIndicators 将 会 被 自动 配置 ， 例 如 在 
pom.xml 文件 中 添加 了 Redis 依赖 ， 此 时 访问 health 端点 ， 结 果 如 图 14-6 所 示 。 





GET ” htep://localhost:8080/actuator/health 
| 一 
Pretty ed 二 
"status": "UP", 
~ "details": { 
4” "diskSpace": { 


"status": "UP", 





241581420544， 
: 24589533184, 
"threshold": 19485760 











图 14-6 
若 开发 者 不 需要 这 么 多 HealthIndicators， 则 可 以 通过 如 下 配置 关闭 所 有 的 HealthIndicators 自 
动 化 配置 : 
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3. 自 定义 Healthlnfo 


除了 Spring Boot 自动 收集 的 这 些 HealthInfo 之 外 , 开发 者 也 可 以 自 定义 HealthInfo,， 只 需要 实 
现 HealthIndicator 接口 即 可 : 





@Component 
public class SangHealth implements HealthIndicator { 
QOverride 
public Health health() { 
if (checkNetwork()) { 
return Health.up() .withDetail ("msg"，" 网 络 连接 正常 . . .") .build(); 
， 
return Health.down() .withDetail("msg"，" 网 络 断 开 . . .") .build(); 








Fearmwm 





代码 解释 : 


@ 开发 者 自 定义 类 实现 HealthIndicator 接口 ， 并 实现 该 接口 中 的 health 方法 。 在 health 方法 中 ， 
checkNetwork 是 一 个 网 络 连接 检查 的 方法 ，Health 中 的 up 和 down 方法 分 别 对 应 两 种 常见 的 
响应 状态 ， 即 “up” 和 “down”。 

@ 默认 的 响应 状态 一 共有 4 种 ， 定 义 在 OrderedHealthAggregator 类 中 ， 分 别 是 DOWN 、 
OUT OF SERVICE、UP、UNKNOWN， 如 果 开 发 者 想 增 加 响应 状态 ， 可 以 自 定义 类 继承 自 
HealthAggregator, 或 者 在 application properties 中 通过 management.health.status.order 属性 进行 
配置 。 


配置 完成 后 ， 假 设 网 络 连接 正常 ， 访 问 health 端点 ， 结 果 如 图 14-7 所 示 。 














GET ™ herp://localhosc8080/actuaror/health 
广 -一 
Pretty ON | 地 
到 攻 
2 "status"”: “UP"， 
3 "details": { 
三 二 "sangHealth": { 
5 "status": "Up"， 
6 "details": |{ 
7 ”msg":“ 网 络 连接 正常 
8 上 
9 }, 
19 "diskSpace 
11 “statu: "UP"， 
127 "details 
13 "total": 136312778752, 
14 "free": 136001826816, 
15 "threshold":; 19485766 
16 } 
17 } 
18 } 
El 


图 14-7 
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如 果 开 发 者 想 要 增加 响应 状态 FATAL， 在 application properties 中 增加 如 下 配置 : 


management .health.status .order=FATAL, DOWN, OUT OF SERVICE,UP,UNKNOWN 


配置 完成 后 ， 就 可 以 在 health 方法 中 返回 自 定义 的 响应 状态 了 ， 修 改 SangHealth 的 health 方 
法 如 下 : 


QComponent 
public class SangHealth implements HealthIndicator { 





QOverride 


public Health health() { 
return Health.status ("FATAL") .withDetail ("msg", "网 络 断 开 ...") .build(); 





} 








修改 完成 后 ， 此 时 启动 Spring Boot 项 目 ， 访 问 health 端点 ， 结 果 如 图 14-8 所 示 。 





GET hetpx/localhosc8080/actuatorfhealth 





Body (2) 日 






"sangHealt 
“status": 
"details": { 

"msg": “网络 断 开 ...” 
} 

}, 

"diskSpace 
"statu 

2 "details 

"total": 136312778752, 

“free": 136001769472, 

"threshold": 10485768 












图 14-8 


注意 ， 此 时 虽然 返回 的 status 为 FATAL， 但 是 HITP 响应 码 是 200， 在 默认 的 4 种 响应 状态 
中 , DOWN\、OUT_ OF SERVICE 的 HTTP 响应 码 为 503, UP、UNKNOWN 的 HITP 响应 码 为 200， 
如 果 开 发 者 需要 对 自 定义 的 响应 状态 配置 响应 码 ， 添 加 如 下 配置 即 可 : 


是 management .health.status.http-mapping .FATAL=503 


此 时 再 访问 health 端点 ， 结 果 如 图 14-9 所 示 。 
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"status": "FATAL"， 


"details": { 
"sangHealth": { 






“total": 136312778752， 
"free": 136001761280, 
"threshold": 16485769 











图 14-9 


14.1.8 ”应 用 信息 


应 用 信息 就 是 通过 /actuatorinfo 接口 获取 到 的 信息 ， 主 要 包含 三 大 类 : 自 定义 信息 、Git 信息 
以 及 项 目 构建 信息 ， 下 面 分 别 来 看 。 

1. 自 定 义 信 息 

自 定义 信息 可 以 在 配置 文件 中 添加 ， 也 可 以 在 Java 代码 中 添加 。 

在 配置 文件 中 添加 是 指 在 application.properties 中 手动 定义 以 info 开头 的 信息 ， 这 些 信息 将 在 
info 端点 中 显示 出 来 ， 例 如 在 application.properties 文件 中 添加 如 下 配置 信息 : 


.app.encoding=@project .build.sourceEncoding@ 
.app.java.source=@java.version@ 


-app.java.target=@java.version@ 
.author.name= 江 南 一 点 十 
.author.email=wangsong0210@gmail.com 





注意 ，@...@ 表 示 引 用 Maven 中 的 定义 。 
添加 这 些 配 置信 息 后 ， 重 启 Spring Boot 项 目 ， 访 问 /actuator/info 端点 ， 结 果 如 图 14-10 所 示 。 
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GET htrp://localhost.8080/actuator/info 
Pretty JsoN vY 己 
i- K 
2 "app": { 
"encoding": "UTF-8", 
"java": { 
"Source": "1.8.8_171", 
6 "target": "1.8.0_171" 
7 } 
3 ), 
"author": { 
"name": “江南 一 点 雨 "， 
”email": "wangsong9216Ggmail.com” 
2 } 
到 | 


图 14-10 


通过 Java 代码 自 定义 信息 只 需要 自 定义 类 继承 自 InfoContributor, 然 后 实现 该 类 中 的 contribute 
方法 即 可 ， 代 码 如 下 : 


@Component 
public class SangInfo implements InfoContributor { 
QOverride 
public void contribute (Info.Builder builder) { 
Map<String, String> info = new HashMap<>(); 
info.put ("name"，" 江 南 一 点 雨 "); 
info.put ("email", "wangsong0210@gmail .com"); 
builder.withDetail ("author", info); 


onoDpp 


上 
口 











”author": { 
"name": “江南 一 点 雨 "， 


"email": "wangsong9219Ggmail.com” 








图 14-11 
2. Git 信息 
Git 信息 是 指 Git 提交 信息 ， 当 classpath 下 存在 一 个 git.properties 文件 时 ，Spring Boot 会 自动 


配置 一 个 GitProperties Bean。 开发 者 可 通过 Git 插件 自动 生成 Git 提交 信息 , 然后 将 这 些 展示 在 info 
端点 中 。 具 体操 作 步 又 如 下 : 
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首先 进入 当前 项 目 目录 下 ， 初 始 化 Git 仓库 并 且 提 交代 码 到 本 地 仓库 ， 代 码 如 下 : 








性 wm 


git init 
2 git add . 
< git commit -m "首次 提交 " 





Git 提交 完成 后 ， 接 下 来 在 pom.xml 中 添加 如 下 plugin: 





<plugin> 

<groupId>p1.project13 .maven</groupId> 
<artifactId>git-commit-id-plugin</artifactId> 
</plugin> 








使 用 该 插件 生成 Git 提交 信息 , 插件 添加 成 功 后 , 接 下 来 在 IntelliJ IDEA 中 单 击 Maven Project， 
然后 找到 该 插件 ， 单 击 git-commit-id:revision 按钮 ， 生 成 Git 提交 信息 ， 如 图 14-12 所 示 。 





Maven Projects 
多 二 | 十 PP 小 图 总 三 | 区 


~ 入 actuator 








> mLfecyde 
v MPlugins 

$clean (org.apache.maven.plugins:maven-clpan-plu 
compiler (org.apache.mav 


时 deploy (c 


《vv v 






git-commit-id 






Na git-commit-id:validateRevision 







寺 install (org.apa 


jar (org.apache.mav 


> 

> 

》 ( 声 resources (org.ap 
》 瞩 site (org.ap 

》 中 spring-boot (o 
》 (surefire (org.a 


> MDependencies 





图 14-12 


gin:3,0,0 
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aseqeyxeq 关 
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Git 提交 信息 生成 成 功 后 ， 在 当前 项 目的 target/classes 目录 下 会 看 到 一 个 git.properties 文件 ， 
打开 就 是 Git 的 提交 信息 ， 如 图 14-13 所 示 。 


基本 上 所 有 的 Git 提交 信息 都 包含 在 这 是 
的 用 户 、 





用 户 邮 箱 等 。 


有 了， 如 分 支 、 提 交 的 版 本 号 、 提 交 的 message、 提 交 


最 后 在 application.properties 中 添加 如 下 配置 ， 表 示 展 示 所 有 的 Git 提交 信息 : 





业 management .info.git.mode=full 


注意 ，management.info.git.mode 的 取 值 还 可 以 是 simple， 表 示 只 展示 一 部 分 核心 提交 信息 。 
配置 完成 后 ， 启 动 Spring Boot 项 目 ， 访 问 info 端点 ， 结 果 如 


信息 都 














示 出 来 了 。 





图 14-14 所 示 ， 所 有 的 Git 提交 
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请 gitproperties * | 




















.branch=aaster 

it. build. host=DBSETOP-26A6AG4 

build. tine=2018-08-10T17\:57\:29+0800 
build. use: il=wangsong0210@gnail. con 
build. user. nane= 江 南 一 点 雨 

build. version=0, 0. 1-SNAPSHOT 


closest. tag. commit. count= 











closest. tag. nane= 

it. id=3al9f88f828894a095c400494761af8ca91f023d 
id. abbrev=3al9f£88 
,id. describe=3al9f88 
.id. describe-short=3al9f88 
ssage, full= 首 次 提交 
comnit. message. short= 首 次 提交 
comait. time=2018-08-10T17\:38\:42+0800 
ail=wangsong0210' 
comait. user. nase= 江 南 一 点 雨 
dirty=false 
remote. origin. url=Unknown 





1.com 





commit, user 





tags= 


图 14-13 








"DESKTOP-26A6AG4", 

"version": "8.8.1-SNAPSHOT"， 

6 "time": "2018-88-10T09:57:292", 
{ 


江南 一 点 雨 "， 























92108gmail. com" 
19 } 
1 }, 
"branch": "master", 
"commit": { 
message， 
区 首次 提交 ”， 
"full": “首次 提交 ” 
:{ 
"describe": "3a19f88", 
"abbrev": "3819f88", 


"describe-short": "3al9f88", 
"full": "3al9f88f828894a095c4006494761laf8ca91f923d" 
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3. 项 目 构建 信息 
如 果 classpath 下 存在 META-INF/build-info.properties 文件 ，Spring Boot 将 自动 构建 
BuildProperties Bean, 然后 info 端点 会 发 布 build-info.properties 文件 中 的 信息 。 build-info.properties 
文件 可 以 通过 插件 自动 生成 。 具 体操 作 步 又 如 下 。 
首先 在 pom .xml 文件 中 添加 插件 : 





<plugin> 


<executions> 
<execution> 
<goals> 


</goals> 
</execution> 


OoIANAODp 





11 | </plugin> 


10 | </executions> 


<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-maven-plugin</artifactId> 


<goal>build-info</goal> 








然后 在 IntelliJ IDEA 中 单 击 Maven Project， 找 到 该 插件 ， 单 击 spring-boot:build-info 按钮 ， 生 
成 构建 信息 ， 如 图 14-15 所 示 。 








Maven Projects 次， 沁 


6 晤 


《vvvvvv 


> 


> 嘱 \Dependencies 







和 过 | 十 | 号 兴国 吕 王 | 区 
§ deploy (org.apache.maven.plugins:maven-deploy-plugin:2: 
git-commit-id (pl.project] 
$install (org.apache.mav 
$jar (org.apache.maven.plugins:maven-jar-plu. 


时 resources 





;site (org.ap 

和 spring-boot ( 
[县 spring-boot:build-info 
NMR spring-boot:help 
MR spring-boot:repackage 
MR spring-boot:run 
Mspring-boot:start 
Nespring-boot:stop 


surefire (org.apache.maven.plugins:maven-surefire-plugin:2 





图 14-15 


构建 信息 生成 成 功 后， 在 当前 项 目 目录 下 的 target/classes/META-INF 目录 下 生成 了 一 个 
build-info.properties 文件 ， 内 容 如 图 14-16 所 示 。 
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build-info.properties 











4 build. artifact=actuator 
build. group=org. sang 
build.name=actuator 
build. version=0. 0. 1-SNAPSHOT 





图 14-16 


此 时 启动 Spring Boot 项 目 ， 访 问 info 端点 ， 构 建 信息 将 被 自动 发 布 ， 如 图 14-17 所 示 。 





GET 7 htrp://localhost:8080/actuator/info 
| 一 
Prerry JsoN v 忆 
2- build": { 


"version": "8.9.1-SNAPSHOT"， 
4 "artifact": "actuator”", 
5 name": "actuator"， 





"time": "2018-98-10T19:12:44.9627” 


| ) 


图 14-17 








14.2 ”监控 信息 可 视 化 


上 一 节 向 读者 介绍 了 监控 端点 ， 返 回 JSON 数据 ， 这 样 查看 起 来 非常 不 方便 。Spring Boot 中 
提供 了 监控 信息 管理 端 ,用 来 实现 监控 信息 的 可 视 化 ,这 样 可 以 方便 开发 者 快速 查看 系统 运行 状况 ， 
而 不 用 去 一 个 一 个 地 调用 接口 。 有 具体 配置 步骤 如 下 : 

首先 创建 一 个 普通 的 Spring Boot Web 工程 ， 添 加 Admin 相关 依赖 ， 代 码 如 下 : 








<dependency> 

<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 
</dependency> 

<dependency> 

<groupId>qe .codecentric</groupId> 
<artifactId>spring-boot-admin-starter-server</artifactId> 
<version>2.0.2</version> 

</dependency> 


oo Dpp 








创建 成 功 后 ， 在 项 目 启动 类 上 添加 @EnableAdminServer 注解 ， 表 示 启 动 AdminServer， 代 码 
如 下 : 
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@Spring BootApplication 
@EnableAdminServer 
public class AdminApplication { 
public static void main(String[] args) { 
SpringApplication.run (AdminApplication.class, args); 
} 





ammwm 


上 








配置 完成 后 ， 启 动 Spring Boot 项 目 ， 在 浏览 器 中 输入 http://localhost:8080/index.html， 结 果 如 
图 14-18 所 示 。 





$B Spring Boot Admin 


APPLICATIONS NSTANCES 


0 0 all up 





图 14-18 
Admin 端 将 通过 图 表 的 方式 展示 监控 信息 。 
接 下 来 开发 Client。Client 实际 上 就 是 一 个 一 个 的 服务 ，Client 将 被 注册 到 AdminServer 上 ， 
行 数据 并 展示 出 来 。 因此, 这 里 使 用 14.1 节 中 的 项 目 作 为 Client， 











然后 AdminServer 获取 Client 的 运 
改造 时 分 为 以 下 两 个 步 又。 
首先 添加 依赖 : 





<dependency> 

<groupId>de.codecentric</groupId> 
<artifactId>spring-boot-admin-starter-client</artifactId> 
<version>2.0.2</version> 

</dependency> 


an mw 





然后 在 application.properties 中 添加 以 下 两 行 配置 : 





革 server.port=8081 
是 spring.boot.admin.client.url=http://localhost:8080 











spring.boot.admin.client.url 表示 配置 AdminServer 地 址 。 
配置 完成 后 , 启动 Client 项 目 , 此 时 在 AdminServer 上 就 可 以 看 到 Client 的 运行 数据 。 图 14-19 
展示 了 当前 注册 到 AdminServer 上 的 Client 列表 。 





< Spring Boot Admin 





图 14-19 
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Wallboard 展示 了 Client 的 简略 信息 ， 如 图 14-20 所 示 。 


偶 :pring Boot Admin 


spring-boot- 


application 


.1-SNAPSHOT 





图 14-20 








单 击 图 14-20 中 的 实例 名 ， 即 可 看 到 Client 运行 的 详细 数据 ， 如 图 14-21 所 示 。 
展示 在 Details 选项 卡 中 ， 其 他 的 选项 卡 都 对 应 不 同 的 端点 数据 。 


一 些 常见 的 


址 





从 Spring Boot Admin 


spring-boot-application 
Instance ad25ae601360 (of 1 


oggors JMX Thronds Mapping: 





Audit log Heap Dump 
























Info Health 
pe sangHeakth Up 
59 网 绍 连 接 正 党 . 
thr 
。 dskspace up 
图 14-21 
Journal 中 则 展示 了 项 目 运 行 日 志 ， 如 图 14-22 所 示 。 


< Spring Boot Admin 





Event Journal 


Application Event 
spring-boot-application INFO_CHANGED 


spring-boot-application ENDPOINTS_DETECTED 


spring-boot-application 


spring-boot-application 


STATUS_CHANGED (UP) 





REGISTERED 
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14.3 ”邮件 报警 


虽然 使 用 AdminServer 可 以 实现 监控 信息 可 视 化 ， 但 是 项 目 运 维 工程 师 不 可 能 一 天 24 小 时 果 
着 屏幕 查看 各 个 应 用 的 运行 状况 , 如 果 在 应 用 运行 出 问题 时 能 够 自动 发 送 邮 件 通 知 运 维 工程 师 , 就 
会 方便 很 多 。 对 此 ，Spring Boot 提供 了 相应 的 支持 。 配 置 方 式 如 下 

修改 14.2 节 的 Admin 工程 ， 添 加 邮件 发 送 依赖 : 





<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-mail</artifactId> 
</dependency> 


性 wm 





接 下 来 在 application.properties 中 配置 邮件 发 送 基本 信息 : 


spring.mail.host=smtp.qq.com 

spring.mail .port=465 
spring.mail.username=xxx@qq.com 

spring.mail .password= 授 权 码 
spring.mail.default-encoding=UTF-8 
spring.mail .properties.mail.smtp.socketFactory.class=javax.net.ssl.SSLSocketFacto 
ry 

spring.mail .properties.mail.debug=true 
spring.boot.admin.notify.mail.from=xxx@qq.com 
spring.boot.admin.notify.mail .to=xxx@qq.com 
spring.boot.admin.notify.mail .cc=xxx@qq.com 
spring.boot.admin.notify.mail.ignore-changes= 


关于 邮件 发 送 的 配置 ， 读 者 可 以 参考 13.1 节 , 第 8~11 行 是 新 添加 的 配置 ， 分 别 表 示 邮 件 的 发 
送 者 、 收 件 人 、 抄 送 地 址 以 及 忽略 掉 的 事件 。 默 认 情 况 下 ， 当 被 监控 应 用 的 状态 变 为 UNKNOWN 
或 者 UP 时 不 会 发 送 报警 邮件 ， 这 里 的 配置 表示 被 监控 应 用 的 任何 变化 都 会 发 送 报警 邮件 。 

配置 完成 后 ， 重 新 启动 AdminServer， 然 后 启动 被 监控 应 用 ， 就 会 收 到 应 用 上 线 的 邮件 报警 ， 
如 图 14-23 所 示 。 


spring-boot-application (ad25ae601360) is UP 
水 流 云 在 <1510 


FoDmnammmwm 

















spring-boot-application (ad25ae601360) is UP 
Instance ad25ae601360 changed status from UNKNOWN to UP 
Status Details diskSpace status UP details total 136312778752 free 136000786432 threshold 10485760 Registration 


Service Url http://DESKTOP-26A6AG4:8081/ 
Health Url http://DESKTOP-26A6AG4:8081/actuator/health 
Management Url http://DESKTOP-26A6AG4:8081/actuator 











图 14-23 


此 时 关闭 被 监控 应 用 ， 就 会 收 到 应 用 下 线 的 邮件 报警 ， 如 图 14-24 所 示 。 
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spring-boot-app! 
上 怕人 ; 水深 去 在 <15 






spring-boot-application (ad25ae601360) is OFFLINE 
Instance ad25ae601360 changed status from UP to OFFLINE 


Status Details 
exception 
io.netty.channel.AbstractChannel$AnnotatedConnectException 


message 
Connection refused: no further information: DESKTOP-26A6AG4/192.168.66.1:8081 


Registration 


Service Url http://DESKTOP-26A6AG4:8081/ 








Health Url http://DESKTOP-26A6AG4:8081/actuator/health 
Management Url http://DESKTOP-26A6AG4:8081/actuator 
图 14-24 


14.4 小 结 


本 章 向 读者 介绍 了 Spring Boot 项 目 中 常见 的 应 用 监控 ， 分 别 介绍 了 端点 的 配置 以 及 监控 数据 
的 可 视 化 ，Spring Boot 提供 的 这 一 整套 应 用 监控 解决 方案 非常 强大 ， 在 常规 项 目 中 稍微 修改 就 可 
以 直接 用 于 生产 环境 了 。 邮 件 报警 则 可 以 使 运 维 工程 师 及 时 获取 应 用 的 运行 信息 , 特别 是 在 应 用 程 
序 下 线 时 及 时 收 到 通知 ， 尽 早 解决 问题 ， 避 免 造成 损失 。 





项 目 构 建 与 部 署 


本 章 概要 


日 构建 JAR 
e 构建 WAR 


Spring Boot 项 目 可 以 内 嵌 Servlet 容器 ,因此 它 的 部 署 变 得 极为 方便 , 可 以 直接 打 成 可 执行 JAR 
包 部 署 在 有 Java 运行 环境 的 服务 器 上 , 也 可 以 像 传统 的 Java Web 应 用 程序 那样 打 成 WAR 包 运 行 。 
下 面 对 两 种 构建 方式 分 别 予 以 介绍 。 


15.1 JAR 


15.1.1 项目 打包 


使 用 spring-boot-maven-plugin 插件 可 以 创建 一 个 可 执行 的 JAR 应 用 程序 ， 前 提 是 应 用 程序 的 
parent 为 spring-boot-starter-parent。 配置 方式 如 下 : 





<build> 

<plugins> 

<plugin> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-maven-plugin</artifactId> 
</plugin> 

</plugins> 





Amo 
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8 [</build> 
配置 完成 后 ， 在 当前 项 目的 根 目录 下 执行 如 下 Maven 命令 进行 打包 : 
二 mvn package 


或 者 在 IntelliJ IDEA 中 单 击 Maven Project， 找 到 Lifecycle 中 的 package 双击 打包 ， 如 图 15-1 
所 示 。 























Maven Projects 浆 - 们 
人 有 二 | 十 | 了 PP 忆 人 汶 国 总 三 | 攻 


Y 访 jar 


v Bslifeoyde 
总 clean 
对 validate 
总 compile 
对 test 





意 verify 

半 install 

灶 site 

便 deploy 
> Plugins 


> BDependencies 








图 15-1 


打包 成 功 后 ， 在 当前 项 目的 根 目录 下 找到 target 目录 ，target 目录 中 就 有 刚刚 打 成 的 JAR 包 ， 
如 图 15-2 所 示 。 


Ml target 

MM classes 

Ml generated-sources 

Ml generated-test-sources 

Ml maven-archiver 

Ml maven-status 

Ml surefire-reports 

Mtest-classes 
jar-0.0.1-SNAPSHOTjar 

5jar-0.0.1-SNAPSHOTJjaroriginal 


让 .gitignore 





jariml 
让 mvnw 


天 mvnw.cmd 





图 15-2 
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这 种 打包 方式 的 前 提 是 项 目 使 用 了 spring-boot-starter-parent 作为 parent, 不 过 在 大 部 分 项 目 中 ， 
项 目的 parent 可 能 并 不 是 spring-boot-starter-parent， 而 是 公司 内 部 定义 好 的 一 个 配置 ， 此 时 
spring-boot-maven-plugin 插件 并 不 能 直接 使 用 ， 需 要 多 做 一 些 额 外 配置 ， 代 码 如 下 : 














于 <plugin> 
2 <groupId>org.springframework.boot</groupId> 

| <artifactId>spring-boot-maven-plugin</artifactId> 
4 <version>2.0.4.RELEASE</version> 

5 <executions> 

6 <execution> 

7 <goals> 

8 <goal>repackage</goal> 

9 |</goals> 

10 | </execution> 


11 | </executions> 
12 | </plugin> 











配置 完成 后 ， 就 可 以 通过 Maven 命令 或 者 IntelliJ] IDEA 中 的 Maven 插件 进行 打包 ， 打 包 方 式 
和 前 文 一 致 ， 不 再 袭 述 。 


15.1.2 项目 运行 


Windows 中 的 运行 比较 容易 ， 直 接 进入 target 目录 中 执行 如 下 命令 即 可 启动 项 目 : 

在 Linux 上 运行 Spring Boot 项 目 需要 确保 Linux 上 安装 了 Java 运行 环境 。 下 面 以 CentOS 7 
为 例 介绍 安装 步骤 。 

首先 下 载 JDK， 通 过 xFTP 等 工具 上 传 到 Linux 上 , 或 者 直接 在 Linux 上 下 载 DK， 下 载 成 功 
后 ， 对 下 载 文 件 进 行 解压 和 重 命名 ， 命 令 如 下 : 





tar -zxvf jdk-8u121-linux-x64.tar.gz 
2 mv jdk1.8.0 121 java 














然后 编辑 当前 用 户 目录 下 的 .bash_profile 文件 ， 配 置 环境 变量 ， 命 令 如 下 : 











和 Vi .bash profile 








在 该 文件 中 分 别 配置 JAVA_HOME、CLASSPATH 以 及 PATH， 添加 完成 后 的 文件 如 图 15-3 
所 示 。 





280 | Spring Boot+Vue 全 栈 开发 实战 








1 | source .bash profile 

接 下 来 通过 xFTP 或 者 其 他 工具 将 生成 的 JAR 包 上 传 到 Linux 上 ,然后 执行 如 下 命令 启动 项 目 : 
1 java -jar jar-0.0.1-SNAPSHOT.jar & 

注意 ， 最 后 面 的 & 表 示 让 项 目 在 后 台 运 行 。 由 于 在 生产 环境 中 ，Linux 大 多 数 情 况 下 都 是 远程 
服务 器 ， 开 发 者 通过 远程 工具 连接 Linux， 如 果 使 用 上 面 的 命令 启动 JAR， 一 旦 窗口 关闭 ，JAR 也 
就 停止 运行 了 ， 因 此 一 般 通 过 如 下 命令 启动 JAR: 
1 nohup java -jar jar-0.0.1-SNAPSHOT.jar & 
这 里 多 了 nohup， 表 示 当 窗口 关闭 时 服务 不 挂 起 ， 继 续 在 后 台 运 行 。 









































15.1.3 创建 可 依赖 的 JAR 


正常 情况 下 ，Spring Boot 项 目 是 一 个 可 以 独立 运行 的 项 目 ， 它 存在 的 目的 不 是 作为 某 一 个 项 
目的 依赖 ， 如 果 有 一 个 项 目 需要 依赖 Spring Boot 中 的 模块 ， 最 好 的 解决 方案 是 将 该 模块 单独 擒 出 
来 ， 创 建 一 个 公共 模块 被 其 他 项 目 依赖 。 但 若 由 于 其 他 原因 导致 该 模块 无 法 单独 擒 出 来 ， 此 时 不 可 
以 直接 使 用 15.1.1 小 节 的 方法 打包 成 JAR 作为 项 目 依赖 ， 因 为 前 面 打 包 的 JAR 是 可 执行 JAR， 它 
的 类 放 在 BOOT-INF 目录 下 ， 如 果 直 接 作为 项 目的 依赖 ， 就 会 找 不 到 类 。 可 执行 JAR 的 结构 图 如 
3 











1 example.jar 

2 1 

3 +-META-INF 

4 | +-MANIFEST.MF 

5 +-org 

6 | +-springframework 

了 | +-boot 

8 1 +-loader 

9 | +-<spring boot loader classes> 
10 +-BOOT-INF 

11 +=clLasses 

12 | +-mycompany 

13 | +-project 

14 | +-YourClasses.class 
5 +-1ib 

16 +-dependencyl .jar 

7 +-dependency2.jar 








因此 ， 如 果 非 要 将 一 个 Spring Boot 工程 作为 一 个 项 目的 依赖 ， 就 需要 配置 Maven 插件 生成 一 
个 单独 的 artifact, 这 个 单独 的 artifact 可 以 作为 其 他 项 目的 依赖 , 配置 方式 如 下 (假设 项 目的 parent 


不 是 spring-boot-starter-parent) : 





<plugin> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-maven-plugin</artifactId> 
<version>2.0.4.RELEASE</version> 





心 wb 
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<executions> 
<execution> 

<goals> 
<goal>repackage</goal> 
</goals> 

</execution> 
</executions> 
<configuration> 
<classifier>exec</classifier> 
</configuration> 
</plugin> 





classifier 指定 了 可 执行 JAR 的 名 字 ， 默 认 的 JAR 则 作为 可 被 其 他 程序 依赖 的 artifact。 配 置 完 
成 后 ， 对 项 目 进行 打包 ， 打 包 成 功 后 ， 在 target 目录 下 生成 了 两 个 JAR， 如 图 15-4 所 示 。 
jar-0.0.1-SNAPSHOT.jar 是 一 个 可 被 其 他 应 用 程序 依赖 的 JAR，jar-0.0.1-SNAPSHOT-exec.jar 
则 是 一 个 可 执行 JAR， 对 这 两 个 JAR 分 别 解压 ， 可 以 看 到 class 路 径 是 不 同 的 ， 如 图 15-5 所 示 。 


- > 
‘idea 


Myn 
SrC 
Ml target 
> Mclasses 


> 
> 
> 
Y 


> Mmaven-archiver 
> Mmaven-status 
> Mtest-classes 
目 jar-0.0.1-SNAPSHOTjar 
目 jar-0.0.1-SNAPSHOT-execjar 
是 .gitignore 
和 jariml 
天 mvnw 


四 mvnw.cmd 





M pom.xml 





图 15-4 


15.1.4 文件 排除 


要 将 Spring Boot 项 目 打包 成 可 执行 JAR， 一 般 需 要 一 些 配置 文件 ， 例 如 application.properties 
或 者 application.yml 等 ， 但 若 将 Spring Boot 项 目 打包 成 一 个 可 依赖 JAR， 这 些 配 置 文件 很 多 时 候 
又 不 需要 ， 此 时 可 以 在 打包 时 排除 配置 文件 ， 配 置 如 下 : 


Y Mtarget 


Ml classes 
Ml jar-0.0.1-SNAPSHOT 
> MMETA-INF 


v Morg 

> Msang 

Plapplication.properties 
Mjar-0.0.1-SNAPSHOT-exec 
v MBOOT-INF 

v Mcasses 





v Morg 
> Msang 
Napplication.properties 
> Mlib 
> MMETA-INF 
v Morg 





> Mspringframework 


图 15-5 








心 ww N 


<plugin> 

<groupId>org .springframework.boot</groupId> 
<artifactId>spring-boot-maven-plugin</artifactId> 
<version>2.0.4.RELEASE</version> 
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] <executions> 

6 <execution> 

前 <goals> 

8 <goal>repackage</goal> 

9 | </goals> 

10 | </execution> 

11 | </executions> 

12 | </plugin> 

13 | <plugin> 

14 | <artifactId>maven-jar-plugin</artifactId> 
15 | <executions> 

16 | <execution> 

17 | <id>lib</id> 

18 | <phase>package</phase> 

19 | <goals> 

20 | <goal>jar</goal> 

21 | </goals> 

22 | <configuration> 

23 | <classifier>lib</classifier> 
24 | <excludes> 

25 | <exclude>application.properties</exclude> 
26 | </excludes> 

27 | </configuration> 

28 | </execution> 

29 | </executions> 

30 | </plugin> 


在 maven-jar-plugin 插件 中 配置 排除 application.properties 配置 文件 。 配 置 完成 后 ， 对 项 目 进行 
打包 ， 打 包 后 生成 两 个 JAR， 如 图 15-6 所 示 。 

jar-0.0.1-SNAPSHOT.jar 是 可 执行 JAR，jar-0.0.1-SNAPSHOT-libjar 是 可 被 外 部 程序 依赖 的 
JAR， 对 jar-0.0.1-SNAPSHOT-lib.jar 进行 解压 ， 发 现 里 面 已 经 没有 application.properties 配置 了 ， 
如 图 15-7 所 示 。 











v Mtarget 
> Mclasses 
v Mjar-0.0.1-SNAPSHOT-lib 
> MMETA-INF 
> Morg 
Ml maven-archiver 


Y Mtarget 

> Mclasses 

> Mmaven-archiver 

> Mmaven-status 

> Mtest-classes 
司 jar-0.0.1-SNAPSHOTjar 
bjar-0.0.1-SNAPSHOT.jar.original 
冯 jar-0.0.1-SNAPSHOT-libjar 


Ml maven-status 

Ml test-classes 

目 jar-0.0.1-SNAPSHOTjar 
5jar-0.0.1-SNAPSHOTJjaroriginal 

目 jar-0.0.1-SNAPSHOT-libjar 











图 15-6 图 15-7 
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15.2 WAR 





在 一 些 特殊 情况 下 ， 需 要 开发 者 将 Spring Boot 项 目 打 成 WAR 包 , 然后 使 用 传统 的 方式 部 署 ， 
打 成 WAR 包 的 配置 步骤 如 下 : 


步骤 014 修改 pomxml 文件 ， 将 项 目 打 成 WAR 包 : 





入 <packaging>war</packaging> 


步 最 024 修改 pomxml 文 件 ， 将 内 说 容器 的 依赖 标记 为 provide， 代 码 如 下 : 








<dependency> 
<groupId>org.springframework.boot</groupId> 


<artifactId>spring-boot-starter-tomcat</artifactId> 
<scope>provided</scope> 
</dependency> 


步骤 034 提供 一 个 Spring BootServletInitializer 的 子 类 ， 并 覆盖 其 configure 方法 , 完成 初始 化 
操作 ， 代 码 如 下 : 





public class ServletInitializer extends Spring BootServletInitializer { 
QOverride 
protected SpringApplicationBuilder configure (SpringApplicationBuilder app) { 


return app.sources (WarApplication.class); 


} 





经 过 以 上 三 步 的 配置 后 ， 接 下 来 就 可 以 对 项 目 进行 打包 了 。 打 WAR 包 的 方式 和 打 JAR 包 的 
方式 是 一 样 的 , 打包 成 功 后 ,在 target 目录 下 生成 一 个 WAR 包 , 将 该 文件 复制 到 Tomcat 的 webapps 
目录 下 ， 启 动 Tomcat 即 可 。 


15.3 小 结 


本 章 主要 向 读者 介绍 了 Spring Boot 项 目 不 同 的 打包 方式 ， 开 发 者 可 以 使 用 传统 的 WAR 包 部 
署 ， 也 可 以 使 用 Spring Boot 官方 推荐 的 JAR 包 部 署 ， 两 种 部 署 方式 各 有 优 缺 点 ， 需 要 开发 者 根据 
实际 情况 选择 合适 的 部 署 方式 。 


微 人 事项 目 实战 


讨 
项 
汗 
问 


微 人 事项 目 介绍 

项 目 技术 架构 

前 后 端 分 离 项 目 构建 
登录 模块 实现 
动态 加 载 用 户 菜单 
邮件 发 送 

员工 资料 导入 导出 
在 线 聊 天 

前 端 项 目 打包 


本 章 将 通过 一 个 前 后 端 分 离 项 目 带 读者 掌握 目前 流行 的 Spring BoottVue 前 后 端 分 离开 发 环境 


的 搭建 以 及 项 目的 开发 流程 。 本 章 重 点 向 读者 介绍 前 后 端 分 





离 环境 的 搭建 以 及 开发 流程 , 也 涉及 少 


量 的 业务 逻辑 本 章 项 目的 完整 代码 可 以 在 GitHub 上 下 载 , 下载 地 址 为 https://github.conylenve/vhr， 











本 章 在 展示 代码 时 仅 展示 项 目 关键 步骤 的 核心 代码 。 





16.1 项 目 简介 


人 事 管 理 系统 是 一 种 常见 的 企业 后 台 管理 系统 ， 它 的 3 





要 目的 是 加 强 各 个 部 门 之 间 的 协调 和 





提高 工作 效率 。 人 事 管 理 系统 提供 了 员工 资料 管理 、 人 事 管 理 、 工 资 管理 、 统 计 管 理 以 及 系统 管理 
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等 功能 ， 通 过 人 事 管理 系统 ， 人 事 组 织 部 门 能 做 到 以 人 为 中 心 , 各 部 门 之 间 实 现 资源 共享 ， 并 且 实 
现 即 时 通信 ， 提 高 工作 效率 ， 简 化 烦琐 的 手工 统计 、 信 息 汇 总 和 工资 业务 等 大 量 的 人 工 工作 ， 让 人 
事 组 织 和 工资 管理 工作 在 人 事 组 织 相关 的 各 部 门 之 间 活 跃 起 来 。 








16.2 ”技术 架构 


本 项 目 采 用 当下 流行 的 前 后 端 分 离 的 方式 开发 ， 后 端 使 用 Spring Boot 开发 ， 前 端 使 用 
Vue+ElementUI 来 构建 SPA。SPA 是 指 Single-Page Application， 即 单 页 面 应 用 ，SPA 应 用 通过 动 
态 重 写 当前 页 面 来 与 用 户 交 互 ， 而 非 传统 的 从 服务 器 重新 加 载 整个 新 页 面 。 这 种 方法 避免 了 页 面 之 
间 切 换 打 断 用 户 体验 ， 使 应 用 程序 更 像 一 个 桌面 应 用 程序 。 在 SPA 中 ， 所 有 的 HIML、JavaScript 
和 CSS 都 通过 单个 页 面 的 加 载 来 检索 ， 或 者 根据 用 户 操作 动态 装载 适当 的 资源 并 添加 到 页 面 。 在 
SPA 中 , 前 端 将 通过 Ajax 与 后 端 通信 。 对 于 开发 者 而 言 ，SPA 最 直观 的 感受 就 是 项 目 开发 完成 后 ， 
只 有 一 个 HTML 页 面 ， 所 有 页 面 的 跳 转 都 通过 路 由 进行 导航 。 前 后 端 分 离 的 另 一 个 好 处 是 一 个 后 
端 可 以 对 应 多 个 前 端 ， 由 于 后 端 只 负责 提供 数据 ， 前 后 端的 交互 都 是 通过 JSON 数据 完成 的 ， 因 此 
后 端 开发 成 功 后 ， 前 端 可 以 是 PC 端 页 面 ， 也 可 以 是 Android、iOS 以 及 微 信 小 程序 等 。 


16.2.1 Vue 简介 


Vue (读音 /vju: /， 类 似 于 view) 是 一 套用 于 构建 用 户 界面 的 渐进 式 框 架 。 与 其 他 大 
型 框架 不 同 的 是 ，Vue 被 设计 为 可 以 自 底 向 上 逐 层 应 用 。Vue 的 核心 库 只 关注 视图 层 ， 
不 仅 易 于 上 手 ， 还 便于 与 第 三 方 库 或 婚 有 项 目 整合 。 另 一 方面 ， 当 与 现代 化 的 工具 链 以 及 
各 种 支持 类 库 结 合 使 用 时 ，Vue 完全 能 够 为 复杂 的 单 页 应 用 提供 驱动 。 

一 一 Vue 官网 


对 于 Vue 的 基础 知识 ， 本 书 不 做 过 多 介绍 ， 由 于 Vue 的 文档 都 是 中 文 文档 ， 因 此 强烈 建议 初 


学 者 通读 官方 文档 来 了 解 Vue 的 基本 使 用 方法 〈 地 址 为 https://cn.vuejs.org/v2/guide/) ， 本 书后 面 
将 直接 介绍 Vue 在 项 目 中 的 使 用 。 





16.2.2 Element 简介 


Vue 桌面 端 组 件 库 非 常 多 ， 比 较 流 行 的 有 Element、Vux、iView、mint-ui、muse-ui 等 ， 本 项 
目 采 用 Element 作为 前 端 页 面 组 件 库 。 要 说 设计 , 这 些 UI 库 差异 都 不 是 很 大 , 基本 上 都 是 Material 
Design 风格 的 ， 本 项 目 采用 Element 主要 考虑 到 该 库 的 使 用 人 数 较 多 (截至 写作 本 书 时 ，Element 
在 GitHub 上 的 star 数 已 达 29 000， 接 近 30 000) ， 出 了 问题 容易 找到 解决 方案 。 关 于 Element 的 
用 法 ， 强 烈 建 议 初学 者 通读 官方 文档 学 习 (地址 为 http://element-cn.eleme.io/#/zh-CN/component) 。 
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16.2.3 ”其 他 





除了 前 端 技 术 点 外 ， 后 端 用 到 的 技术 主要 就 是 第 1~15 章 提 到 的 技术 ， 这 里 就 不 详细 展开 了 。 


16.3 项目 构 建 


16.3.1 前 端 项 目 构建 


Vue 项 目 使 用 webpack 来 构建 。 首 先 确 保本 地 已 经 安装 了 NodeJS， 然 后 在 CMD 中 执行 如 下 
命令 ， 可 以 创建 并 启动 一 个 名 为 vuehr 的 前 端 项 目 : 


npm install -g vue-cli 
vue init webpack vuehr 


cd vuehr 
npm run dev 


在 执行 “vue init webpack vuehr” 命 令 时 ， 会 要 求 依次 输入 项 目的 基本 信息 ， 如 图 16-1 所 示 。 








图 16-1 


基本 信息 主要 包括 : 

ee 项 目 名 称 。 

@ 项 目 描述 。 

@ 项 目 作者 。 

@ Vue 项 目 构建 : 运行 + 编译 还 是 仅 运行 。 

@ 是 否 安装 vue-router。 

日 是 否 使 用 ESLint。 

@ 是 否 使 用 单元 测试 。 

@ 是 否 适 用 Nightwatch e2e 测试 。 

@ 是 否 在 项 目 创建 成 功 后 自动 执行 “npm install” 安 装 依赖 ， 若 选择 否 ， 则 在 第 4 行 命令 执行 之 
前 执行 “npm install”。 


当 “npm run dev” 命 令 执行 之 后 ， 在 浏览 器 中 输入 http://localhost:8080， 显 示 页 面 如 图 16-2 
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所 CO © lccahost3080/s, 谥 








Welcome to Your Vue.js App 


Essential Links 






nily Chat Taitte 


Ecosystem 





wemuler yex yaloader awesomeyue 





图 16-2 


16.3.2 ”后 端 项 目 构建 


后 端 使 用 Spring Boot 创建 一 个 Spring Boot 工程 ， 添 加 spring-boot-starter-web 依赖 即 可 : 
<dependency> 
<groupId>org.springframework.boot</groupId> 


<artifactId>spring-boot-starter-web</artifactId> 
</dependency> 





当然 ， 后 端 所 需 的 依赖 不 止 spring-boot-starter-web， 在 后 文 功能 不 断 完善 的 过 程 中 ， 青 继续 添 
加 其 他 依赖 。 另 外 ， 后 端 项 目 所 需 的 Redis 配置 、 邮 件 发 送 配 置 、POI 配置 、WebSocket 配置 等 ， 
将 在 涉及 相关 功能 时 向 读者 介绍 。 


16.3.3 ”数据 模型 设计 


完整 的 数据 库 脚本 可 以 在 GitHub 上 下 载 ， 下 载 地 址 为 https://github.comy/lenve/ 
vhr/blob/master/hrserver/src/main/resources/vhr.sql， 这 里 仅 展 示 本 项 目的 数据 字典 。 
adjustsalary 表 〈 员 工 调 薪 表 ) 如 表 16-1 所 示 。 





表 16-1 adjustsalary 表 























字段 名 逻辑 名 数据 类 型 约束 说 明 

jd Integer 主键 ， 自 增长 ”| 主键 

eid Integer 外 键 , 普通 索引 | 员工 id 
asDate Date 调 薪 日 期 
beforeSalary Integer 调 前 薪资 
afterSalary Integer 调 后 薪资 
reason String(255) 调 薪 原因 











Temark String(255) 备注 
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appraise 表 ( 员 


工 评 价 表 ) 如 表 16-2 所 示 。 


表 16-2 appraise 表 






































字段 名 逻辑 名 数据 类 型 约束 说 明 
id Integer 主键 ， 自 增长 ”| 主键 
eid Integer 外 键 , 普通 索引 | 员工 id 
appDate Date 考评 日 期 
appResult String(32) 考评 结果 
appContent String(255) 考评 内 容 
remark String(255) 备注 

department 表 〈 部 门 表 ) 如 表 16-3 所 示 。 

表 16-3 一 一 - 表 

id Integer es Er 自 增 长 主键 
name | svingGD) | 一 一 一 
parentId | | 和 | | 部 ] id 
depPath | swing05) | | path 
enabled | |Emm | 中 认 值 , 1 | 是 否 可 用 
isparent | [mwm | 默认 值 , 0 | 是否 为 父 部 站 


employee 表 (员工 信 息 


\ 表 ) 如 表 16-4 所 示 。 


表 16-4 employee 表 
























































字段 名 逻辑 名 说 明 

id Integer 主键 ， 自 增长 ”| 员工 编号 
name String(10) 员工 姓名 
gender String(4) 性 别 
birthday Date 出 生日 期 
idCard String(18) 身份 证 号 
wedlock String(2) 婚姻 状况 
nationId Integer(8) 外 键 , 普通 索引 | 民族 
nativePlace String(20) 籍贯 
politicId Integer(8) 外 键 , 普通 索引 | 政治 面貌 
email String(20) 邮箱 
phone String(11) 电话 号 码 
address Strine(64) 联系 地 址 
departmentId Integer 外 键 , 普通 索引 | 所 属 部 门 
jobLevelId Jnteger 外 键 , 普通 索引 | 职称 卫 
posId Integer 外 键 , 普通 索引 | 职位 卫 
engageForm String(8) 聘用 形式 
tiptopDegree String(2) 最 高 学 历 
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( 续 表 ) 

字段 名 逻辑 名 数据 类 型 约束 说 明 
specialty String(32) 所 属 专业 
school String(32) 毕业 院 校 
beginDate Date 入 职 日 期 
workState String(2) 默认 值 : 在 职 | 在 职 状 态 
worked String(8) 普通 索引 工 号 
contractTerm Float 合同 期 限 
conversionTime Date 转正 日 期 
notWorkDate Date 离职 日 期 
beginContract Date 合同 起 始 日 期 
endContract Date 合同 终止 日 期 
workAge Integer 工龄 

employeeec 表 〈 员 工 奖惩 表 ) 如 表 16-5 所 示 。 

表 16-5 employeeec 表 

字段 名 数据 类 型 说 明 
id Integer 主键 ， 自 增长 主键 
eid 外 键 , 普通 索 引 | 员工 编号 
eoDate | pe | | 其 
ecReason | swing055) | | 奖 负 原 办 
ecPoint | ee | | 
ecType | me | | 和 类别 0 交 明 
remark | stingos) | | 条 注 

employeeremove 表 (员工 调 岗 表 ) 如 表 16-6 所 示 。 

表 16-6 employeeremove 表 

字段 名 逻辑 名 数据 类 型 约束 说 明 
id Integer 主键 
eid Integer 外 键 ， 普通 索引 | 员工 id 
afterDepId Integer 调动 后 部 门 
afterJobId Integer 调动 后 职位 
removeDate Date 调动 日 期 
reason String(255) 调动 原因 
remark String(255) 备注 

employeetrain 表 (员工 培训 表 〉 如 表 16-7 所 示 。 

表 16-7 employeetrain 表 

字段 名 逻辑 名 数据 类 型 约束 说 明 
id Integer 主键 ， 自 增长 ”| 主键 
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( 续 表 ) 
字段 名 逻辑 名 数据 类 型 约束 说 明 
eid Integer 外 键 , 普通 索引 | 员工 编号 
trainDate | Date | 培训 日 期 
trainContent | sting(255) | 培训 内 容 
remark | string(255) | 备注 

















empsalary 表 (员工 薪资 关联 表 ) 如 表 16-8 所 示 。 


表 16-8 empsalary 表 








字段 名 | 逻辑 名 数据 类 型 约束 说 明 
id Integer 主键 ， 自 增长 主键 
eid Integer ， 普 通 索 引 | 员工 id 








sid Integer ， 普 通 索 引 | 薪资 id 
hr 表 (hr 表 ) 如 表 16-9 所 示 。 
表 16-9 hr 表 


字段 名 说 明 













id E 键 ， 自 增长 ”| huD 

name | |stse) | | 好 名 

phone | |smieD | | 
telephone | |smieul9g | | 住 放 晤 
address | swine6) | | 联系 地 址 
enabled 账户 是 否 可 用 
Usemame | swing05) | | 用 Ap% 
password String(255) 密码 
userface String(255) 用 户头 像 
remark String(255) 备注 








hr role 表 (hr 角色 表 ) 如 表 16-10 所 示 。 


表 16-10 hr_role 表 

















字段 名 逻辑 名 数据 类 型 约束 说 明 
id LE， 自 增长 主键 id 
hrid EL， 普通 索引 | 操作 员 id 
rid Integer 外 键 ， 普 通 索 引 | 角色 id 
joblevel 表 〈 职 称 表 ) 如 表 16-11 所 示 。 
表 16-11 joblevel 表 
字段 名 逻辑 名 数据 类 型 约束 说 明 











i 主键 ， 自 增长 主键 
name 职称 名 称 
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字段 名 | 逻辑 名 数据 类 型 约束 说 明 

titleLevel | String(3) 职称 级 别 

createDate | Date 默认 值 : 创建 日 期 
CURRENT TIMESTAMP 

enabled Enum 默认 值 : 1 是 否 可 用 


menu 表 (菜单 表 ) 如 表 16-12 所 示 。 


表 16-12 menu 表 

















字段 名 逻辑 名 数据 类 型 约束 说 明 

id Integer 主键 ， 自 增长 ”| 主键 

ul String(64) 请 求 路 径 规 则 

path String(64) 路 由 path 

component String(64) 组 件 名 称 

name String(64) 组 件 名 

iconCls String(64) 菜单 图 标 

keepAlive Enum 菜单 切换 时 是 否 保 活 
requireAuth Enum 是 否 登录 后 才能 访问 
parentId Integer 外 键 , 普通 索引 | 父 菜单 id 

enabled Enum 默认 值 : 1 是 否 可 用 








menu role 表 (菜单 角色 关联 表 ) 如 表 16-13 所 示 。 


表 16-13 menu_role 表 





字段 名 
id | |mteger | 主键, 自 增长 | 
mid | | meger | 外 键 , 普通 索引 
rid Integer 外 键 ， 普 通 索 引 


说 明 


主键 
菜单 id 
角色 id 





msgcontent 表 《〈 消 息 内 容 表 ) 如 表 16-14 所 示 。 


表 16-14 msgcontent 表 





主键 ， 自 增长 








Inessage String(255) 








Date 非 空 ， 默 认 值 : 


createDate | 


CURRENT TIMESTAMP 





nation 表 《〈 民 族 表 ) 如 表 16-15 所 示 。 
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表 16-15 _ nation 表 





字段 名 i 数据 类 型 约束 说 明 
id Integer 主键 ， 自 增长 ”| 主键 


name String(32) 名 称 











oplog 表 (操作 日 志 表 ) 如 表 16-16 所 示 。 
表 16-16 oplog 表 








字段 名 逻辑 名 数据 类 型 约束 说 明 
id Integer 主键 
addDate Date 添加 日 期 


操作 内 容 











operate String(255) 
hrid Integer 外 键 ， 普通 索引 | 操作 员 ID 


politicsstatus 表 〈 政 治 面貌 表 ) 如 表 16-17 所 示 。 


表 16-17 ”politicsstatus 表 


字段 名 数据 类 型 说 明 
id | | eser | 主键, 自 增长 | 主键 
name | smimee»y | | 5 称 


position 表 〈 职 位 表 ) 如 表 16-18 所 示 。 





表 16-18 position 表 


字段 名 说 明 
id | | meger | 主键, 自 增长 主键 
Name | | sme | 叭 过 | 职位 
createDate 默认 值 : 创建 日 期 


CURRENT TIMESTAMP 











enabled 默认 值 : 1 是 否 可 用 


role 表 ( 角 色 表 ) 如 表 16-19 所 示 。 








表 16-19 role 表 
字段 名 i 数据 类 型 约束 说 明 
id TInteger 主键 ， 自 增长 主键 





name String(64) 角色 名 称 











nameZh String(64) 角色 中 文 名 称 
salary 表 〈 薪 水 表 ) 如 表 16-20 所 示 。 


表 16-20 salary 表 





数据 类 型 约束 说 明 








字段 名 示 辑 名 








Integer 主键 ， 自 增长 | 主键 
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( 续 表 ) 
字段 名 逻辑 名 说 明 
basicSalary 基本 工资 
bonus 奖金 
lunchSalary 午餐 补助 
trafficSalary 交通 补助 
allSalary 应 发 工资 





pensionBase 养老 金 基 数 
pensionPer Float(12,31) 养老 金 比率 
createDate 启用 时 间 
medicalBase Integer 医疗 基数 
medicalPer Float(12,31) 医疗 保险 比率 
accumulationFundBase Integer 公积金 基数 


accumulationFundPer 公积金 比率 
name String(32) 账 套 名 称 
sysmsg 表 ( 系 统 消息 表 ) 如 表 16-21 所 示 。 
表 16-21 sysmsg 表 


数据 类 型 i 
| ieser | 主键, 自 增长 | 主键 
| Imeger | 外 键 ， 普通 索引 | 消息 i 


























fm Wo | 
| | ms | 外 键 ， 普通 索 引 |3 
| [me [Wo | 











经 过 以 上 准备 工作 ， 项 目 环境 就 已 经 基本 搭建 成 功 了 。 另 外 ， 对 于 Redis 的 安装 、 启 动 等 ， 读 
者 可 以 参考 第 6 章 ， 这 里 不 再 歼 述 。 


16.4 登录 模块 


16.4.1 后 端 接口 实现 


后 端 权限 认证 采用 Spring Security 实现 (本 小 节 中 大 量 知识 点 与 第 10 章 的 内 容 相关 ， 需 要 读 
者 熟练 掌握 第 10 章 的 内 容 ) ,数据库 访问 使 用 MyBatis, 同时 使 用 Redis 实现 认证 信息 缓存 。 因 此， 
后 端 首先 添加 如 下 依赖 (依次 是 MyBatis 依赖 、Spring Security 依赖 、Redis 依赖 、 数 据 库 连 接 池 依 
赖 、 数 据 库 驱 动 依赖 以 及 缓存 依赖 〉: 


1 <dependency> 





2 <groupId>org.mybatis.spring.boot</groupId> 
3 <artifactId>mybatis-spring-boot-starter</artifactId> 
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4 <version>1.3.2</version> 

和 </dependency> 

6 <dependency> 

7 <groupId>org.springframework.boot</groupId> 

8 <artifactId>spring-boot-starter-security</artifactId> 
9 | </dependency> 

10 | <dependency> 

4 <groupId>org.springframework.boot</groupId> 

12 <artifactId>spring-boot-starter-data-redis</artifactId> 
13 <exclusions> 

14 <exclusion> 

15 <groupId>io.lettuce</groupId> 

16 <artifactId>lettuce-core</artifactId> 

17 </exclusion> 

18 </exclusions> 


19 | </dependency> 

20 | <dependency> 

21 <groupId>redis.clients</groupId> 
22 <artifactId>jedis</artifactId> 
23 | </dependency> 

24 | <dependency> 


25 <groupId>com.alibaba</groupId> 
26 <artifactId>druid</artifactId> 
27 <version>1.1.10</version> 


28 | </dependency> 

29 | <dependency> 

30 <groupId>mysql</groupId> 

31 <artifactId>mysql-connector-java</artifactId> 

32 | </dependency> 

33 | <dependency> 

34 <groupId>org. springframework.boot</groupId> 

35 <artifactId>spring-boot-starter-cache</artifactId> 
36 | </dependency> 


依赖 添加 完成 后 ， 接 下 来 在 application.properties 中 配置 数据 库 连 接 、Redis 连接 以 及 缓存 等 。 








1 | #MYySOL 配 置 

攻 spring.datasource.type=com.alibaba.druid.pool.DruidDataSource 
3 spring.datasource.url=jdbc:mysql://127.0.0.1:3306/vhr 
4 spring.datasource.username=root 

和 spring.datasource.password=root 

6 #MyBatis 日 志 配置 

了 mybatis.config-location=classpath:/mybatis-config.xml 
8 #Redis 配置 

9 spring.redis.database=0 

10 | spring.redis.host=192.168.66.130 

11 | spring.redis.port=6379 

12 | spring.redis.password=123@456 

13 | spring.redis.jedis.pool.max-active=8 

14 | spring.redis.jedis.pool.max-idle=8 

15 | spring.redis.jedis.pool.max-wait=-1lms 
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16 | spring.redis.jedis.pool.min-idle=0 

17 | # 缓 存 配置 

18 | spring.cache.cache-names=menus cache 
19 | spring.cache.redis.time-to-live=1800s 
20 | # 端 口 配置 

21 | server.port=8082 











配置 完成 后 ， 接 下 来 实现 用 户 认证 的 配置 。 用 户 认证 使 用 Spring Security 实现 ， 因 此 需要 首先 
提供 一 个 UserDetails 的 实例 ， 在 人 事 管 理 系统 中 ， 登 录 操 作 是 HE 登录 ， 根 据 前 面 的 二 表 创 建 三 


实体 类 并 实现 UserDetails 接口 ， 代 码 如 下 : 





1 public class Hr implements UserDetails { 
之 private Long id; 
3 private String name; 
4 private String phone; 
5 private String telephone; 
6 private String address; 
7 private boolean enabled; 
8 private String username; 
9 private String password; 
0 private String remark; 
1 private List<Role> roles; 
入 private String userface; 
3 QOverride 
4 public boolean isEnabled() { 
5 return enabled; 
6 } 
QOverride 
8 public String getUsername () { 
六 return username; 
20 } 
21 QJsonIgnore 
22 QOverride 
23 public boolean isAccountNonExpired() { 
24 return true; 
好 } 
26 Q@JsonIgnore 
27 QOverride 
28 public boolean isAccountNonLocked() { 
29 return true; 
30 } 
31 Q@JsonIgnore 
Er QOverride 
33 public boolean isCredentialsNonExpired() { 
34 return true; 
35 } 
36 Q@JsonIgnore 
37 QOverride 


Ww 
名 


public Collection<? extends GrantedAuthority> getAuthorities() { 
List<GrantedAuthority> authorities = new ArrayList<>(); 





Co 
be 
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40 for (Role role : roles) { 
41 authorities.add (new SimpleGrantedAuthority (role.getName())); 
42 } 

43 return authorities; 

44 } 

45 Q@JsonIgnore 

46 QOverride 

47 public String getPassword() { 
48 return password; 

49 } 

50 // 省 上 getter/setter 

全 小 寺 





代码 解释 : 


@ 自 定义 类 继承 自 UserDetails， 并 实现 该 接口 中 相关 的 方法 。 前 端 用 户 在 登录 成 功 后 ， 需 要 获 
取 当 前 登录 用 户 的 信息 ， 对 于 一 些 敏感 信息 不 必 返 回 ， 使 用 @JsonIgnore 注解 即 可 。 

@ 对 于 isAccountNonExpired、isAccountNonLocked、isCredentialsNonExpired， 由 于 Hr 表 并 未 
设计 相关 字段 ， 因 此 这 里 直接 返回 true，isEnabled 方法 则 根据 实际 情况 返回 。 

@ roles 属性 中 存储 了 当前 用 户 的 所 有 角色 信息 ， 在 getAuthorities 方法 中 ， 将 这 些 角色 转换 为 
List<GrantedAuthority> 的 实例 返回 。 


接 下 来 提供 一 个 UserDetailsService 实例 用 来 查询 用 户 ， 代 码 如 下 : 











1 @Service 

2 | public class HrService implements UserDetailsService { 

3 @Autowired 

4 HrMapper hrMapper; 

号 QOverride 

6 public UserDetails loadUserByUsername (String s)throws UsernameNotFoundException{ 
和- Hr hr = hrMapper.1loadUserByUsername (s); 

8 if (hr == null) { 

9 throw new UsernameNotFoundException ("用 户 名 不 存在 ") ; 
10 } 

11 return hr; 

2 } 

13 1} 





自 定义 五 Service 实现 UserDetailsService 接口 ， 并 实现 该 接口 中 的 loadUserByUsemame 方法 ， 
loadUserByUsername 方法 是 根据 用 户 名 查询 用 户 的 所 有 信息 ， 包 括 用 户 的 角色 ， 如 果 没 有 查 到 相 
关 用 户 ， 就 抛 出 UsemameNotFoundException 异常 ， 表 示 用 户 不 存在 ， 如 果 查 到 了 ， 就 直接 返回 ， 
Spring Security 框架 完成 密码 的 比 对 操作 。 

接 下 来 需要 实现 动态 配置 权限 ， 因 此 还 需要 提供 FilterInvocationSecurityMetadataSource 和 
AccessDecisionManager 的 实例 。 
FilterInvocationSecurityMetadataSource 代码 如 下 : 




















1 @Component 
2 public class CustomMetadataSource implements FilterInvocationSecurityMetadataSource 
3 | 
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QRAutowired 
MenuService menuService; 
AntPathMatcher antPathMatcher = new AntPathMatcher (); 
QOverride 
public Collection<ConfigAttribute> getAttributes (Object o) { 
String requestUrl = ((FilterInvocation) o) .getRequestUr] (); 
List<Menu> allMenu = menuService.getAllMenu(); 
for (Menu menu : allMenu) { 
if (antPathMatcher.match (menu.getUrl(), requestUr]l) 
&&menu.getRoles () .size()>0) { 
List<Role> roles = menu.getRoles(); 
int size = roles.size(); 
String[] values = new String[size]; 
for (int i = 0; i < size; i++) { 
values[i] = roles.get (i) .getName(); 
} 


return SecurityConfig.createList (values); 


} 
return SecurityConfig.createList ("ROLE LOGIN"); 

} 

QOverride 

public Collection<ConfigAttribute> getAllConfigAttributes() { 
return null; 


} 
QOverride 
public boolean supports (Class<?> aClass) { 
return FilterInvocation.class.isAssignableFrom(aClass); 





代码 解释 : 

ee 在 getAttributes 方法 中 首先 提取 出 请 求 URL， 根 据 请 求 URL 判断 该 请 求 需要 的 角色 信息 。 

e@ 通过 MenuService 中 的 getAllMenu 方法 获取 所 有 的 菜单 资源 进行 比 对 ， 考 虑 到 getAttributes 
方法 在 每 一 次 请 求 中 都 会 调用 ， 因 此 可 以 将 getAllMenu 方法 的 返回 值 缓存 下 来 ， 下 一 次 请 求 
时 直接 从 缓存 中 获取 。 

日 对 于 所 有 未 匹配 成 功 的 请 求 ， 默 认 都 是 登录 后 访问 。 


AccessDecision Manager 代码 如 下 : 





oAMAODPp 





@Component 
public class UrlAccessDecisionManager implements AccessDecisionManager { 
QOverride 
public void decide (Authentication auth, Object o, Collection<ConfigAttribute> 
cas){ 
Iterator<ConfigAttribute> iterator = cas.iterator(); 
while (iterator.hasNext()) { 
ConfigAttribute ca = iterator.next (); 
String needRole = ca.getAttribute(); 
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10 让 ("ROLE IOGIN" .equals (needRole)) { 

if (auth instanceof AnonymousAuthenticationToken) { 
歼 throw new BadCredentialsException(" 未 登录 "); 
3 } else 

14 return; 

35 } 

16 Collection<? extends GrantedAuthority> authorities = 
17 | auth.getAuthorities(); 

18 for (GrantedAuthority authority : authorities) { 

19 if (authority.getAuthority() .equals (needRole)) { 
20 return; 

21 } 

22 } 

23 } 

24 throw new AccessDeniedException ("权限 不 足 !"); 

站 } 

26 QOverride 

2 public boolean supports (ConfigAttribute configAttribute) { 
28 return true; 

29 } 

30 QOverride 

31 public boolean supports (Class<?> aClass) { 

32 return true; 











代码 解释 : 


e@ 在 decide 方 法 中 判断 当前 用 户 是 否 具备 请 求 需要 的 角色 , 若 该 方法 在 执行 过 程 中 未 抛 出 异常 ， 
则 说 明 请 求 可 以 通过 ; 若 抛 出 异常 ， 则 说 明 请 求 权限 不 足 。 

@ 如果 所 需要 的 角色 是 ROLE LOGIN， 那 么 只 需要 判断 auth 不 是 匿名 用 户 的 实例 ， 即 表示 当 
前 用 户 已 登录 。 


接 下 来 提供 一 个 AccessDeniedHandler 的 实例 来 返回 授权 失败 的 信息 : 





oo DPPp 


上 
情书 


> 户 
心 





@Component 
public class AuthenticationAccessDeniedHandler implements AccessDeniedHandler { 
QOverride 
public void handle (HttpServletRequest httpServletRequest, HttpServletResponse 
resp, 
AccessDeniedException e) throws IOException { 
resp.setstatus (HttpServletResponse.SsC FORBIDDEN); 
resp.setContentType ("application/json;charset=UTF-8"); 
PrintWriter out = resp.getWriter(); 
RespBean error = RespBean.error ("权限 不 足 ， 请 联系 管理 员 !") ; 
out.write (new ObjectMapper() .writeValueAsString (error)); 
out.flush(); 
out.close(); 
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当 授 权 失 败 时 ， 在 这 里 返回 授权 失败 的 信息 。 
当 所 有 准备 工作 完成 后 ， 接 下 来 配置 Spring Security， 代 码 如 下 : 











加 Dowmemwm 





wo Po 


心心 心心 必 必 上 上 wmwmmwmwmwwmwmwmwmbbmnbmbmmbmmm 
疝 四 唱 必 用 口 四 加 门 贡 四 上 由 有 并 吕 加 虽 门 上 口 心 wwn 己 





@Configuration 
@EnableGlobalMethodSecurity (prePostEnabled = true) 
public class WebSecurityConfig extends WebSecurityConfigurerAdapter { 
@Autowired 
HrService hrService; 
@Autowired 
CustomMetadataSource metadataSource; 
@Autowired 
UrlAccessDecisionManager urlAccessDecisionManager; 
QAutowired 
AuthenticationAccessDeniedHandler deniedHandler; 
QOverride 
protected void configure (AuthenticationManagerBuilder auth) throws Exception { 
auth.userDetailsService (hrService) 
.passwordEncoder (new BCryptPasswordEncoder () ) ; 
} 
QOverride 
public void configure (WebSecurity web) throws Exception { 
web.ignoring () .antMatchers ("/index.html", "/static/**", "/login p"); 
} 
QOverride 
protected void configure (HttpSecurity http) throws Exception { 
http.authorizeRequests () 
.WithObjectPostProcessor (new 
ObjectPostProcessor<FilterSecurityInterceptor>() { 
QOverride 
public <0O extends FilterSecurityInterceptor> 0 postProcess(0 o) { 
o.setSecurityMetadataSource (metadataSource); 
o.setRccessDecisionManager (urlAccessDecisionManager); 
return o7 


}) 
-and() 
.formLogin () .loginPage("/login _p") .loginProcessingUrl("/1ogin") 
.UsernameParameter ("username") .passwordParameter ("password" 
.failureHandler (new AuthenticationFailureHandler() { 
@Override 
public void onAuthenticationFailure (HttpServletRequest reqg, 
HttpServletResponse resp, 
AuthenticationException e) throws IOException { 
resp.setContentType ("application/json;charset=utf-8"); 
RespBean respBean = null; 
if (e instanceof BadCredentialsException || 
e instanceof UsernameNotFoundException) { 
respBean = RespBean.error ("账户 名 或 者 密码 输入 错误 !1") ; 
} else if (e instanceof LockedException) { 


respBean = RespBean.error ("账户 被 锁定 ， 请 联系 管理 员 !") ; 
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48 } else if (e instanceof CredentialsExpiredException) { 
49 respBean = RespBean.error(" 密 码 过 期 ， 请 联系 管理 员 !") ; 
50 } else if (e instanceof AccountExpiredException) { 
Si respBean = RespBean.error ("账户 过 期 ， 请 联系 管理 员 !") ; 
52 } else if (e instanceof DisabledException) { 
$3 respBean = RespBean.error ("账户 被 禁用 ， 请 联系 管理 员 !1") ; 
54 } else { 
55 respBean = RespBean.error ("登录 失败 !"); 
56 } 
57 resp.setStatus (401); 
58 ObjectMapper om = new ObjectMapper (); 
59 PrintWriter out = resp.getWriter(); 
60 out.write (om.writeValueAsString (respBean)); 
61 out.flush(); 
62 out.close(); 
63 
64 ]) 
65 .SuccessHandler (new AuthenticationSuccessHandler() { 
66 Q@Override 
67 public void onAuthenticationSuccess (HttpServletRequest req, 
68 HttpServletResponse resp, 
69 Authentication auth) throws IOException { 
70 resp.setContentType ("application/json;charset=utf-8"); 
71 RespBean respBean = RespBean.ok(" 登 录 成 功 !"，HrUtils.getCurrentHr ()); 
72 ObjectMapper om = new ObjectMapper () ; 
73 PrintWriter out = resp.getWriter(); 
74 out .write (om.writeValueAsString (respBean) ) ; 
75 out .flush() 7 
76 out.close(); 
77 } 
78 ]) 
79 .permitAll () 
80 .and() 
81 .logout () .permitAll () 
82 .and() .csrf().disable() 
83 .exceptionHandling() .accessDeniedHandler (deniedHandler) 
84 } 
} 
代码 解释 : 
e 首先 通过 @EnableGlobalMethodSecurity 注解 开启 基于 注解 的 安全 配置 ， 启 用 @PreAuthorize 
和 (@PostAuthorize 两 个 注解 。 


e 在 配置 类 中 注入 之 前 创建 的 4 个 Bean， 在 AuthenticationManagerBuilder 中 配置 
userDetailsService 和 passwordEncoder。 

@ 在 WebSecurity 中 配置 需要 忽略 的 路 径 。 

e 在 HttpSecurity 中 配置 拦截 规则 、 表 单 登录 、 登 录 成 功 或 失败 的 响应 等 。 

@ 最 后 通过 accessDeniedHandler 配置 异常 处 理 。 
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另外 ， 前 文 提 到 MenuService 中 的 getAllIMenu 方法 在 每 次 请 求 时 都 需要 查询 数据 库 ， 效 率 极 
内 此 可 以 将 该 数据 缓存 下 来 ， 代 码 如 下 : 
QService 


@Transactional 
Q@CacheConfig (cacheNames = "menus cache") 








京 














public class MenuService { 

@Autowired 

MenuMapper menuMapper; 

@Cacheable (key = "#root .methodName") 

public List<Menu> getAllMenu(){ 
return menuMapper.getAllMenu(); 

} 








FRRiDowDawmmwmh 


[ee 





这 里 使 用 方法 名 作为 缓存 的 key， 另 外 需要 在 项 目 启 动 类 上 添加 @EnableCaching 注解 开启 





经 过 前 面 这 一 整套 的 配置 后 ， 登 录 认 证 接口 已 经 搭建 成 功 了 ， 接 下 来 可 以 使 用 Postman 等 工 
具 进 行 测试 了 。 
登录 测试 如 图 16-3 所 示 。 





POST ~ 





Prerty SON Y Er 





"remark”": 
1 "roles": [ 





”userface": "http://bpic.588ku.com/element_pic/61/46/66/54573ce2edc8728 .jpg” 





中 





图 16-3 

















登录 成 功 后 ， 访 问 http://localhost:8082/employee/advanced/hello 接口 ， 由 于 当前 用 户 不 具备 相 
应 的 角色 ， 访 问 结果 如 图 16-4 所 示 。 
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GET htrp://localhost:8082/employee/advanced/hello 


2 "status": 500， 
3 "msg": “权限 不 足 ， 请 联系 管理 员 !"， 


4 "obj": null 








图 16-4 
若 访问 http://localhost:8082/employee/basic/hello 地 址 , 则 可 以 看 到 正常 的 结果 ,如 图 16-5 所 示 。 


http://localhost:8082/employee/basic/hello 


retty 


1 basicHello 





图 16-5 


确认 后 端 接 口 均 可 以 正常 运行 后 ， 接 下 来 开发 前 端 。 


16.4.2 ”前 端 实现 


1. 引入 Element 和 Axios 
前 端 UI 使 用 Element， 网 络 请 求 则 使 用 Axios， 因 此 首先 安装 Element 和 Axios 依赖 ， 代 码 如 
下 : 


1 npm i element-ui -S 
npm i axios -S 


依赖 添加 成 功 后 ， 接 下 来 在 main.js 中 引入 Element， 代 码 如 下 : 





import ElementUI from "element-ui" 
import "element-ui/1lib/theme-chalk/index.css" 
Vue.use (ElementUI) 





引入 Element 之 后 ， 接 下 来 就 可 以 在 项 目 中 直接 使 用 相关 组 件 了 。 

对 于 网 络 请 求 ， 由 于 在 每 一 次 请 求 时 都 需要 判断 各 种 异常 情况 ， 然 后 提示 用 户 ， 例 如 请 求 是 
和 否 成 功 、 失 败 的 原因 等 ,考虑 到 这 些 判 断 基本 上 都 使 用 重复 的 代码 ， 因 此 可 以 将 网 络 请 求 封装 ， 做 
成 Vue 的 插件 方便 使 用 。 由 于 封装 的 代码 比较 长 , 这 里 就 不 贴 出 来 了 , 读者 可 以 在 GitHub 上 查看 ， 
地 址 为 https://github.conylenve/vhr/blob/master/vuehr/src/utils/apijs。 配 置 完成 后 ， 在 main.js 中 导入 
封装 的 方法 ， 然 后 配置 为 Vue 的 prototype， 代 码 如 下 : 


import {getRequest} from './utils/api" 
2 import {postRequest} from "./utils/api" 
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import {deleteRequest} from './utils/api' 
import {putRequest} from './utils/api" 
Vue.prototype.getRequest = getRequest; 

Vue .prototype.postRequest = postRequest; 
Vue.prototype.deleteRequest = deleteRequest; 
Vue.prototype.putRequest = putRequest; 


co -ao ww 








配置 完成 后 ， 接 下 来 对 于 任何 需要 使 用 网 络 请 求 的 地 址 ， 都 可 以 使 用 this.XXX 执行 一 个 网 络 


请 求 ， 例 如 要 执行 登录 请 求 ， 就 可 以 通过 this.postRequest(url,param) 执 行 。 
2. 开发 Login 页 面 
接 下 来 在 components 目录 下 创建 Login.vue 页 面 进行 登录 页 面 开发 ， 代 码 如 下 : 











1 <template> 

EF <el-form :rules="rules" class="login-container" label-position="left" 
< label-width="0px" v-loading="loading"> 

4 | <h3 class="login title"> 系 统 登录 </h3> 

5 <el-form-item prop="account"> 

6 <el-input type="text" v-model="loginForm.username" 

7 auto-complete="off" placeholder=" 账 号 "></el-input> 
8 | </el-form-item> 

9 <el-form-item prop="checkPass"> 

0 | <el-input type="password" v-model="loginForm.password" 

和 auto-complete="off" placeholder=" 密 码 "></el-input> 
2 | </el-form-item> 

3 | <el-checkbox class="login remember" v-model="checked" 

4 label-position="left"> 记 住 密码 </el-checkbox> 

5 | <el-form-item style="width: 100%"> 

6 | <el-button type="primary" style="width: 100%" 

7 | @click="submitClick"> 登 录 </el-button> 

8 | </el-form-item> 

9 | </el-form> 

20 | </template> 

21 | <script> 

22 export default{ 

23 data(){ 

24 return { 

25 rules: { 

26 account: [{required: true，message: ' 请 输入 用 户 名 '，trigger: 'blur'}], 
27 checkPass: [{required: true，message: ' 请 输入 密码 '，trigger: 'blur'}] 
28 }, 

29 checked: true, 

30 loginForm: { 

31 username: "admin'， 

32 password: "123" 

33 }, 

34 loading: false 

35 | 

36 ] 

37 methods: { 
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38 submitClick: function () { 
39 var this = this; 
40 this.loading = true; 
41 this.postRequest ('/login', { 
42 username: this.loginForm.username, 
43 password: this.loginForm.password 
44 }) .then (resp=> { 
45 _this.loading = false; 
46 if (resp && resp.status == 200) { 
47 var data = resp.data; 
48 _this.$store.commit ('login', data.obj); 
49 var path = this.$route.query.redirect; 
50 _this.$router 
51 | .replace({path: path == '/' || path == undefined ? '/home' : path}); 
52 } 
53 D); 
54 } 
55 } 
56 } 
57 | </script> 
58 | <style> 
59 .login-container { 
60 border-radius: 15px; 
61 background-clip: padding-box; 
62 margin: 180px auto; 
63 width: 350px; 
64 padding: 35px 35px 15px 35px; 
65 background: #fff; 
66 border: lpx solid #eaeaea; 
67 box-shadow: 0 0 25px #cac6c6; 
68 } 
69 .login _ title { 
70 margin: 0px auto 40px auto; 
i text-align: center; 
又 color: #505458; 
33 
74 .login remember { 
75 margin: 0px 0px 35px Opx; 
76 text-align: left; 
3 } 
78 | </style> 
代码 解释 : 


@ 系统 登录 使 用 Element 中 的 el-form 来 实现 。 同 时 使 用 了 Element 标签 提供 的 校 验 规则 。 

日” 当 用 户 单 击 “登录 ”按钮 时 ， 通 过 thispostRequest 方法 发 起 一 个 登录 请 求 ， 登 录 成 功 后 ， 将 
登录 的 用 户 信 息 保存 到 store 中 ， 同 时 跳 转 到 Home 页 ， 或 者 菜 个 重 定向 页 面 。 

3. 配置 路 由 

登录 页 面 开 发 完成 后 ， 接 下 来 在 路 由 中 配置 登录 页 面 ， 代 码 如 下 : 


第 16 章 微 人 事项 目 实战 | 305 








1 import Vue from 'vue' 

2 import Router from 'vue-router"' 

3 import Login from '@/components/Login' 
4 import Home from '@/components/Home" 
$ Vue.use (Router) 

6 

7 export default new Router({ 

8 routes: [ 

有 { 

10 paths 7 

11 name: "Login'"， 

2 component: Login, 

13 hidden: true 

14 Ws 

15 path: '/home', 

16 name: ' 主 页 '， 

2 component: Home, 

18 hidden: true, 

19 meta: { 

20 requireAuth: true 











另外 ， 由 于 main.js 是 入 口 JIS， 在 main.js 中 导入 了 App 组 件 ，App 组 件 默认 有 Vue 的 Logo， 
将 Logo 图 片 删除 ， 只 保留 一 个 <router-view/> 即 可 ， 修 改 后 的 App.vue 如 下 : 
<template> 
<div id="app"> 
<router-view/> 
</div> 
</template> 


4. 配置 请 求 转发 

最 后 ， 由 于 前 端 项 目 和 后 端 项 目 在 不 同 的 端口 下 启动 ， 前 端的 网 络 请 求 无 法 直接 发 送 到 后 端 ， 
因此 需要 配置 请 求 转发 。 下 面 介绍 配置 方式 。 

修改 config 目录 下 的 indexjs 文件 ， 修 改 proxyTable， 代 码 如 下 : 








1 proxyTable: { 

坟 | 

3 target: 'http://localhost:8082', 
4 changeOrigin: true, 

5 pathRewrite: { 

6 i 

7 } 

8 }, 

9 s/waf*": { 

10 target: 'ws://127.0.0.1:8082"', 








11 Ws: true 
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12 
13 1 和 5 














这 里 配置 了 两 条 规则 ， 第 一 条 是 配置 HITP 请 求 转发 ， 第 二 条 是 配置 WebSocket 请 求 转发 ， 
WebSocket 请 求 在 本 项 目的 即时 通信 模块 中 会 用 到 。 


5. 启动 前 端 项 目 


做 完 这 些 操作 后 , 接 下 来 打开 CMD 命令 窗口 , 进入 当前 项 目 目录 下 , 执行 如 下 命令 启动 项 目 : 


1 npm run dev 





如 果 开 发 者 使 用 WebStorm 开发 前 端 项 目 ， 也 可 以 单 击 WebStorm 右上 角 的 下 拉 按 钮 〈 见 图 


16-6) ， 然 后 单 击 +， 选 择 npm ( 见 图 16-7) ， 配 置 Name 和 启动 脚本 〈 见 图 16-8) 。 


+4 月 溯 
Add New Configuration 
车 Atach to Nodejs/Chrome 
§ Compound 
®@ Cucumberjs 
全 Dar Command Line App 
者 Dart Remote Debug 
坊 Dart Test 
Wy Docker » 
@ Firefox Remote 
从 Gruntjs 
中 Gulpjs 
局 JavaScript Debug 
BJest 
XK Karma 
沪 Meteor 
© Mocha 











Name: |dev 





QO Nodejs 
[Fl i 
和 NWjs 
图 16-7 





























Share 回 Single instance only 











配置 完成 后 ， 就 可 以 直接 通过 单 如 





二 WebStommn 右上 角 的 “启动 ”按钮 启动 项 目 了 ， 如 





packagejson: E:\workspace\vue\V-hr\vuehr\packagejson v| 夺 
Command: run pa 
Scripts: dev v 
Arguments: 
Node interpreter | Project C\Program Files\nodejs\node.exe 8113v 
Node options: 
Package manager: ”Project gral e 品 e_modules\npr ~ 
Environment: 

图 16-8 


图 16-9 所 示 。 


第 16 章 微 人 事项 目 实战 | 307 








加 dev ~ PY. 吃 国 








图 16-9 
6. 测试 


当前 端 项 目 启动 成 功 后 ， 接 下 来 在 浏览 器 中 输入 http://localhost:8080， 即 可 看 到 登录 页 面 ， 如 
图 16-10 所 示 。 


CE 村 豆 ; 
© 全 Oocaosta080/z/ 





系统 登录 








图 16-10 


输入 用 户 名 和 密码 ， 单 击 “ 登 录 ” 按 钮 ， 即 可 登录 成 功 ， 通 过 Chrome 调试 工具 可 以 看 到 登录 
请 求 ， 如 图 16-11 所 示 。 


Name % Headers Preview Response Cookies Timing 
ME v {status: 289，msg: “登录 成 功 !",-) 
Dign msg: "登录 成 功 
品 Yobj: fid: 3，name; "系统 管理 员 " ，phone: “18568887789"，telephone; “829-62881234"，addre5s: “深圳 商 山 "，enabled: true,-} 
OR adoress:“ 深 放 南 山 " 
[DD sysmsgs enabled: true 
DD infort=1534515279969 
"系统 管理 员 " 
"18568887789" 


+ [fid: 5，name: "ROLE_acnin"，nasezh: "系统 管理 员 "}] 
telephone: “629-82881234” 


userface: “http://bpic.588ku.com/element_pic/91/46/981654573ce2edc8728.jpg” 
Username: "admin 


status: 299 





16-11 


至 此 ， 登 录 功 能 就 实现 了 。 这 里 展示 的 只 是 部 分 核心 代码 ， 完 整 代码 可 以 在 GitHub 上 下 载 ， 
下 载 地 址 为 https://github.conylenve/vhr。 
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16.5 ”动态 加 载 用 户 菜单 





用 户 菜单 就 是 用 户 登 录 成 功 后 首页 左 侧 显示 的 菜单 , 如 图 16-12 所 示 。 这 个 菜单 数据 是 根据 用 


户 的 角色 动态 加 载 的 , 即 不 同 身 份 的 用 户 登录 成 功 后 看 到 的 菜单 是 不 一 样 的 。 接 下 来 看 这 个 功能 如 
何 实现 。 





图 16-12 


16.5.1 后 端 接口 实现 


后 端 接口 的 实现 比较 容易 ， 根 据 登 录用 户 的 id 查询 该 用 户 具 有 的 角色 ， 再 根据 角色 信息 查看 
对 应 的 Menu， 数 据 模型 如 图 16-13 所 示 。 








menu_role 
od Pint 
mid int 
rd 





keepAlive I 
requireAuth ryint 
parentd Ir 














16-13 


第 16 章 微 人 事项 目 实战 | 309 





首先 创建 MenuMapper， 根 据 用 户 id 查询 Menu， 代 码 如 下 : 


public interface MenuMapper { 
List<Menu> getMenusByHrId (Long hrId) 


// 省 略 其 他 方法 





1 
加 
3 
4 





对 应 的 MenuMapper.xml 文件 中 则 根据 当前 用 户 id 查询 用 户 可 以 查看 的 角色 ， 查 询 SQL 如 下 
( 源 文件 过 大 ， 这 里 就 不 展示 了 ， 完 整 文件 可 以 在 GitHub 上 下 载 ， 下 载 地 址 为 
https://github.com/lenve/vhr/blob/master/hrserver/src/main/java/org/sang/mapper/MenuMapper.xml) : 





1 SELECT DISTINCT ml.*,m2. id” RS id2,m2. ‘component. AS commponent2,m2. enabled” RS 
2 enabled2,m2 .keepRlive` RS keepAlive2,m2. ‘name. RS name2,m2.path` AS path2,m2. “url. 
3 AS url2,m2. “requireAuth. RS requireaAuth2,m2.…parentId`” RS parentId2 FROM menu ml,menu 
4 m2,menu role mr,role r,hr role hrr WHERE ml. id`=m2. parentId” RND mr.‘rid‘=r.“id. 
5 AND mr. mid`=m2. id” AND hrr. rid`=r. id” AND hrr.‘hrid‘=#{id} 





然后 分 别 创建 MenuService 和 ConfigController，ConfigController 用 来 返回 基本 的 系统 配置 信 





息 。 
MenuService 代码 如 下 : 
1 @Service 
4 public class MenuService { 
a @Autowired 
4 MenuMapper menuMapper; 
5 public List<Menu> getMenusByHrId() { 
6 return menuMapper.getMenusByHrId (HrUtils.getCurrentHr () .getId()); 
7 } 
8 // 省 略 其 他 方法 
9 |} 
10 | public class HrUtils { 
11 public static Hr getCurrentHr () { 
12 return (Hr) 


13 | SecurityContextHolder.getContext () .getAuthentication() .getPrincipal (); 
14 } 
} 


其 中 ，HrUtils 是 一 个 工具 方法 ， 用 来 返回 当前 登录 用 户 的 信息 。 

















ConfigController 代码 如 下 : 
1 @RestController 
2 @RequestMapping ("/config") 
3 public class ConfigController { 
4 QAutowired 
5 MenuService menuService; 
6 QRequestMapping ("/sysmenu") 
时 public List<Menu> sysmenu() { 
8 return menuService.getMenusByHrId(); 
9 } 
10 | } 
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16. 


不 建议 将 


配置 完成 后 ， 启 动 Spring Boot 项 目 , 访问 http://localhost:8082/config/sysmenu 接口 ， 即 可 看 到 
当前 登录 用 户 所 能 查看 的 菜单 数据 ， 如 图 16-14 所 示 。 











GET * hrrp://localhosc8082/config/sysmenu 
Pretty JSON 5 
We [ 
A { 
3 "id"s 2, 
4 "path": "/home", 
component": "Home 
6 "name”"; "员工 资料 
7 "iconCls": "fa fa-user-circle-0", 
8 "children": [ 
9 { 
19 "id": null, 
11 "path": "/emp/basic"， 
12 "component": "EmpBasic", 
13 "name": "基本 资料 " 
14 "iconCls": null, 
15 "children": []， 
16 ~ ”meta": { 
17 "KeepAlive": false, 
18 "requireAuth": true 
19 } 
29 } 
21 ]， 
“meta": { 
23 "keepAlive": false, 
24 "requireAuth": true 
25 } 
26 ), 
27" { 
28 "id": 3, 
29 "path": "/home", 


5.2 前端 实现 


后 端 返 回 了 菜单 数据 ， 前 端 请 求 该 接口 获取 菜单 数据 ， 这 里 的 步骤 很 简单 ， 主 要 分 两 步 ; 


e 将 服务 端 返回 的 JSON 动态 添加 到 当前 路 由 中 。 
日 “将 服务 端 返回 的 JSON 数据 保存 到 store 中 ， 然 后 各 个 Vue 页 面 根据 store 中 的 数据 来 泻 染 菜单 。 


这 里 涉及 的 第 一 个 问题 是 请 求 时 机 ， 即 何 时 去 请 求 菜 单数 据 。 如 果 直 接 在 登录 成 功 之 后 请 求 
菜单 资源 ， 那 么 在 请 求 到 JSON 数据 之 后 ， 将 其 保存 在 store 中 ， 以 便 下 一 次 使 用 。 但 是 这 样 会 有 
一 个 问题 : 假如 用 户 登 录 成 功 之 后 ， 单 击 Home 页 的 某 一 个 按钮 ， 进 入 某 一 个 子 页 面 中 ， 然 后 按 一 
下 FS 键 进行 刷新 ， 这 个 时 候 就 会 出 现 空白 页 面 ， 因 为 按 F5 键 刷新 之 后 store 中 的 数据 就 没 了 ， 而 
我 们 又 只 在 登录 成 功 的 时 候 请 求 了 一 次 菜单 资源 。 要 解决 这 个 问题 ， 有 两 种 方案 : 方案 一 ,不 要 将 
菜单 资源 保存 到 store 中 ， 而 是 保存 到 localStorage 中 ， 这 样 即 使 按 F5 键 刷新 之 后 数据 还 在 ; 方案 
二 , 直接 在 每 一 个 页 面 的 mounted 方法 中 都 加 载 一 次 菜单 资源 。 由 于 菜单 资源 是 非常 敏感 的 ， 因 此 











其 保存 到 本 地 ， 故 舍弃 方案 一 , 但 是 方案 二 的 工作 量 有 点 大 ,而 且 也 不 易 维护 ， 这 里 可 以 
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使 用 路 由 中 的 导航 守卫 来 简化 方案 二 的 工作 量 。 下 面 介绍 具体 实现 步骤 。 
首先 在 store 中 创建 一 个 routes 数组 ， 这 是 一 个 空 数组 ， 代 码 如 下 : 


























1 import Vue from 'vue' 

2 import Vuex from 'vuex' 

3 

4 Vue.use (Vuex) 

5 

6 export default new Vuex.Store ({ 
这 state: { 

8 routes: [] 

9 }, 

10 mutations: { 

11 initMenu(state, menus){ 
12 state.routes = menus; 
13 } 

14 | DD; 





然后 开启 路 由 全 局 守卫 ， 代 码 如 下 : 














bp router .beforeEach ( (to, from, next)=> { 
2 if (to.name == 'Login') { 
3 next () 7 
4 return; 
5 } 
6 Var name = store.state.user.name; 
条 if (name == ' 未 登录 ') { 
8 if (to.meta.requireAuth || to.name == null) { 
9 next ({path: '/', query: {redirect: to.path}}) 
10 } else { 
i next (); 
12 } 
13 } else { 
14 initMenu (router, store); 
15 next (); 
16 } 
了 } 
18 |) 
代码 解释 : 


@ 这 里 使 用 router.beforeEach 配置 了 一 个 全 局 前 置 守卫 。 

日 首先 判断 目标 页 面 是 不 是 Login， 若 是 Login 页 面 ， 则 直接 通过 ， 因 为 Login 页 面 不 需要 菜单 
数据 。 

e@ 接 下 来 获取 store 中 保存 的 当前 登录 的 用 户 数据 ， 若 获取 到 的 用 户 名 为 “未 登录 "， 则 表示 用 
户 尚未 登录 ， 在 用 户 尚未 登录 的 情况 下 ， 如 果 要 跳 转 到 某 一 个 页 面 ， 就 需要 判断 该 页 面 是 否 
要 求 登 录 后 才能 访问 ， 若 要 求 了 ， 则 直接 跳 转 到 登录 页 面 ， 并 配置 redirect 参数 。 若 用 户 已 
经 登录 ， 则 先 执 行 initMenu 方法 初始 化 菜单 数据 ， 然 后 通过 next0; 进 入 下 一 个 页 面 。 


初始 化 菜单 的 操作 如 下 : 
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于 export const initMenu = (router, store)=> { 

2 if (store.state.routes.length > 0) { 

3 return; 

4 } 

5 getRequest ("/config/sysmenu") .then (resp=> { 

6 if (resp && resp.status == 200) { 

2 var fmtRoutes = formatRoutes (resp.data); 

8 router .addRoutes (fmtRoutes); 

9 store.commit ('initMenu', fmtRoutes); 

10 } 

1 ]) 

12 

13 | export const formatRoutes = (routes)=> { 

14 let fmRoutes = []; 

15 routes .forEach (router=> { 

16 let { 

17 path, 

18 component, 

19 name, 

20 meta, 

21 iconCls, 

22 children 

23 } = router; 

24 if (children && children instanceof Array) { 

25 children = formatRoutes (children); 

26 } 

27 let fmRouter = { 

28 path: path, 

29 component (resolve) { 

30 if (component.startsWith("Home")) { 

3 require(['../components/' + component + '.vue'], resolve) 

32 } else if (component.startsWith("Emp")) { 

33 require(['../components/emp/'"' + component + '.vue'], resolve) 
34 } else if (component.startsWith("Per")) { 

35 require(['../components/personnel/' + component + '.vue'], resolve) 
36 } else if (component.startsWith("Sal")) { 

3 require(['../components/salary/' + component + '.vue'], resolve) 
38 } else if (component.startsWith("Sta")) { 

39 require(['../components/statistics/' + component + '.vue'], resolve) 
40 } else if (component.startsWith("Sys")) { 

41 require(['../components/system/' + component + '.vue'], resolve) 
42 | 

43 [Re 

44 name: name, 

45 iconCls: iconCls, 

46 meta: meta, 

47 children: children 

48 }; 

49 fmRoutes .push (fmRouter); 








]) 
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51 
52 


return fmRoutes; 


EL 








代码 解释 : 

@ ”在 初始 化 菜单 中 ,首先 判 断 store 中 的 数据 是 否 存在 ， 如 果 存 在 ， 则 说 明 这 次 跳 转 是 正常 的 跳 
转 ， 而 不 是 用 户 按 F5 键 或 者 直接 在 地 址 栏 输入 某 个 地 址 进入 的 ， 这 时 直接 返回 ， 不 必 执 行 
菜单 初始 化 。 

@ 若 store 中 不 存在 菜单 数据 ， 则 需要 初始 化 菜单 数据 ， 通 过 getRequest("/config/sysmenu") 方 法 
获得 菜单 JSON 数据 之 后 ， 首 先 通 过 formatRoutes 方法 将 服务 器 返回 的 JSON 转 为 router 需 
要 的 格式 ， 这 里 主要 是 转 component， 因 为 服务 端 返回 的 component 是 一 个 字符 串 ， 而 router 
中 需要 的 却 是 一 个 组 件 ， 因 此 我 们 在 formatRoutes 方法 中 根据 服务 端 返回 的 component 动态 
加 载 需 要 的 组 件 即 可 。 

@ ”数据 格式 准备 成 功 之 后 ， 一 方面 将 数据 存 到 store 中 ， 另 一 方面 利用 路 由 中 的 addRoutes 方法 
将 之 动态 添加 到 路 由 中 。 


加 载 到 路 由 数据 之 后 ， 接 下 来 就 是 菜单 泻 染 了 。 菜 单 泻 染 操作 在 Home.vue 组 件 中 完成 ， 部 分 


核心 代码 如 下 : 

1 <template> 

2 <div> 

3 <el-container class="home-container"> 

4 <el-header class="home-header"> 

5 | </el-header> 

6 | <el-container> 

了 <el-aside width="180px" class="home-aside"> 

8 <div> 

9 <el-menu unique-opened router> 

10 | <template v-for=" (item, index) in this.routes" v-if="!item.hidden"> 
11 | <el-submenu :key="index" :index="index+' 7 "> 

12 | <template slot="title"> 

13 | <i :class="item.iconCls"></i> 

14 | <span slot="title">{{item.name}}</span> 

15 | </template> 

16 | <el-menu-item width="180px" 

17 Vv-for="child in item.children" 
18 :index="child.path" 

19 :key="child.path">{{child.name}} 
20 | </el-menu-item> 

21 | </el-submenu> 

22 | </template> 

23 | </el-menu> 

24 | </div> 

25 | </el-aside> 

26 | <el-main> 

27 | </el-main> 

28 | </el-container> 

29 | </el-container> 
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30 | </div> 

31 | </template> 

32 | <script> 

33 export default{ 

34 computed: { 

35 user(){ 

36 return this.$store.state.user; 
37 }, 

38 routes () { 

39 return this.$store.state.routes 
40 } 

41 } 

42 } 

43 | </script> 








代码 解释 : 
日 在 计算 属性 中 返回 routes 数据 。 
e@ 遍历 routes 中 的 数据 ， 根 据 routes 中 的 数据 泻 染 出 el-submenu 和 el-menu-item。 


配置 完成 后 ， 启 动 前 端 项 目 ， 使 用 不 同 的 身份 登录 ， 登 录 成 功 后 ， 就 可 以 看 到 不 同 用 户 对 应 
不 同 的 操作 菜单 了 。 图 16-15 所 示 是 系统 管理 员 看 到 的 菜单 数据 。 图 16-16 所 示 是 用 户 曾 巩 看 到 的 
菜单 数据 。 


系统 管理 员 (有) 








图 16-15 





旺 人 事 管理 





16-16 
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动态 加 载 用 户 菜单 就 完全 实现 了 ， 完 整 代码 可 以 在 https://github.com/lenve/vhr 下 载 。 


16.6 ”员工 资料 模块 


完成 登录 模块 和 菜单 加 载 模块 之 后 ， 一 个 前 后 端 分 离 的 项 目 框架 基本 上 就 搭建 成 功 了 。 接 下 








来 是 业务 的 开发 ,主要 是 后 端 提供 接口 ， 前端 提 供 页 面 并 请 求 数据 。 下 面向 读者 介绍 员工 资料 模块 
的 开发 。 员 工资 料 模块 页 面 如 图 16-17 所 示 。 
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图 16-17 








16.6.1 后 端 接口 实现 


oo DPp 








员工 基本 资料 数据 的 展示 ， 后 端 只 需要 提供 一 个 分 页 查询 + 条 件 查 询 的 接口 即 可 ， 代 码 如 下 : 





@RequestMapping (value = "/emp", method = RequestMethod.GET) 
public Map<String, Object> getEmployeeByPage( 
@RequestParam (defaultValue = "1") Integer page, 


@RequestParam (defaultValue "10") Integer size, 
@RequestParam (defaultValue = "") String keywords, 
Long politicId, Long nationId, Long posId, 

Long jobLevellId, String engageForm, 

Long departmentId, String beginDateScope) { 

Map<String, Object> map = new HashMap<>(); 

List<Employee> employeeByPage = empService.getEmployeeByPage (page, size, 
keywords, politicId, nationId, posId, jobLevelld, engageForm, 
departmentId, beginDateScope); 

Long count = empService.getCountByKeywords (keywords, politicId, nationId, 
posId, jobLevellId, engageForm, departmentId, beginDateScope); 

map.put ("emps", employeeByPage); 

map.put ("count", count); 








316 | Spring Boot+Vue 全 栈 开发 实战 











17 return map; 
18 | } 








分 页 查询 中 ，page 默认 为 1，size 默认 为 10， 查 询 关 键 字 keywords 默认 为 空 字符 串 ， 后 面 几 
个 参数 则 根据 政治 面貌 、 民 族 、 职 位 、 职 称 、 聘 用 形式 、 部 门 以 及 入 职 日 期 查询 。 有 具体 的 查询 代码 
比较 简单 ， 这 里 就 不 贴 出 来 了 。 

后 端 接口 开发 成 功 后 ， 先 用 Postman 进行 测试 ， 结 果 如 图 16-18 所 示 。 











GET hxrp//localhosc8082/employee/basic/emp 
Body (1) (9) 
Pretty 一 四 一 


1989-12-31T16:80:00.9000+0000"，, 
: 0122199991911256", 

"wedlock": “已 婚 "， 

”nativeplace": “陕西 "， 

"email": "laowang8qq.com", 








"engageForm": 
16 "tiptopDegree 本 

1 "specialty" 息 管 理 与 信息 系统 ”， 

18 "school": "深圳 大 学 "， 

19 "beginDate": “2017-12-31T16:00:00.000+0906"， 
"workState": "在 职 "， 
"workID": "8860086001", 

"contractTerm": 2, 

"conversionTime": "2018-63-31T16:00:00.006+0000"， 
"notWorkDate": null, 

"beginContrac 2617-12-31T16:00:00.000+0000"， 
“endContract": “2019-12-31T16:00:09.000+0009"， 
"workAge": null,| 


图 16-18 


圭 

















员工 资料 中 的 基本 资料 一 项 ， 接 口 设 计 规则 为 “/employee/basic/**”， 这 是 为 了 和 数据 库 保 
持 一 致 ， 防 止 没有 权限 的 用 户 拿 到 请 求 接口 后 直接 去 请 求 数 据 。 





确认 后 端 接口 可 以 调 通 后 ， 接 下 来 就 可 以 开发 前 端 页 面 了 。 


16.6.2 ”前 端 实现 


前 端 数据 的 展示 使 用 Element 中 的 表格 来 实现 。 在 components 目录 下 创建 emp 文件 夹 ， 然 后 
在 emp 文件 夹 下 创建 EmpBasic.vue 用 来 展示 前 端 数据 。 注意 , 这 里 之 所 以 将 页 面 放 在 emp 目录 下 ， 
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是 为 了 配合 16.5 节 提 到 的 菜单 数据 格式 化 (在 数据 格式 化 时 , 设置 员工 资料 相关 的 页 面 都 放 在 emp 











目录 下 ) 。 
EmpBasic.vue 核心 代码 如 下 : 
于 <template> 
2 <div> 
| <el-container> 
4 <el-header> 
5 </el-header> 
6 <el-main> 
时 <el-table 
8 :data="emps" 
9 Vv-loading="tableLoading" 
0 border 
于 stripe 
4 Q@selection-change="handleSelectionChange" 
3 size="mini" 
4 style="width: 100%"> 
5 | <el-table-column 
6 prop="gender" 
7 label=" 性 别 " 
8 width="50"> 
9 | </el-table-column> 
20 | <el-table-column 
21 width="85" 
22 align="left" 
23 label=" 出 生日 期 "> 
24 | <template slot-scope="scope"> 
25 {{ scope.row.birthday | formatDate}} 
26 </template> 
27 | </el-table-column> 
28 | <el-table-column 
29 prop="idCard" 
30 width="150" 
3 align="left" 
32 label=" 身 份 证 号 码 "> 
33 | </el-table-column> 
34 
35 | <!-- 省 略 部 分 代码 -一 
36 
3 
38 | </el-table> 
39 | </div> 
40 | </el-main> 
41 | </el-container> 
42 | </div> 
43 | </template> 
44 | <script> 
45 export default { 
46 data() { 
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47 return { 
48 emps: [], 
49 keywords: '" 
50 } 
i }; 
2 bs 
53 mounted: function () { 
54 this.loadEmps (); 
55 }, 
56 methods: { 
57 loadEmps () { 
58 var this = this; 
59 this.tableLoading = true; 
60 this.getRequest ("/employee/basic/emp?page=" + this.currentPage 
61 + "&size=10&gkeywords=" + this.keywords) .then (resp=> { 
62 this.tableLoading = false; 
63 if (resp && resp.status == 200) { 
64 var data = resp.data; 
65 _this.emps = data.emps; 
66 _this.totalCount = data.count; 
67 . 
68 }) 
69 } 
70 } 
71 is 
72 | </script> 
代码 解释 : 
@ 首先 在 data 中 定义 emps 用 来 存放 所 有 员工 的 JSON 数据 ， 然 后 定义 keywords 用 来 存放 查询 


的 关键 字 。 









e@ ”在 加 载 该 页 面 时 ， 在 mounted 中 调用 loadEmps 初始 化 员工 数据 。 
另外 注意 , 表格 中 的 日 期 使 用 formatDate 过 滤器 实现 日 期 的 格式 化 , formatDate 是 一 个 全 局 过 


formatDate 过 滤器 定义 如 下 : 


omDnamwm 必 wm 








import Vue from "vue' 
Vue.filter ("formatDate", formatDate); 


function formatDate(value) { 


var date = new Date (value); 
var year = date.getFullYear(); 
var month = date.getMonth() + 1; 
var day = date.getDate(); 
if (month < 10) { 
month = "0" + month; 
} 
if (day < 10) { 
day = "0" + day; 
} 
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14 
15 


return year + "-" + month + "-" + day; 








经 过 以 上 几 步 配置 后 ， 读 者 就 可 以 看 到 如 图 16-17 所 示 的 效果 图 了 。 


16.7 “配置 邮件 发 送 


在 员工 资料 模块 ，hr 表 可 以 手动 录入 员工 数据 ， 当 一 个 员工 数据 被 成 功 录入 系统 后 ， 系 统 会 


自动 向 该 员工 发 送 一 封 欢迎 入 职 邮 件 ， 要 实现 这 个 功能 非常 容易 〈 关 于 详细 的 邮件 发 送 配置 ， 读 者 
可 以 参考 13.1 节 ) ， 下 面 介绍 其 具体 配置 。 


oOoODpp 


ammwm 








首先 在 后 端 项 目 中 引入 邮件 发 送 相关 依赖 : 


<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-mail</artifactId> 
</dependency> 


<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-thymeleaf</artifactId> 
</dependency> 


这 里 除了 邮件 发 送 依赖 外 ， 还 引入 了 Thymeleaf 依赖 ，Thymeleaf 的 作用 是 构建 邮件 模板 。 
依赖 添加 成 功 后 ， 接 下 来 在 application.properties 中 配置 邮件 : 


spring.mail.host=smtp.qq.com 

spring.mail .port=465 

spring.mail.username=xxx@qq.com 

spring.mail.password=13.1.1 小 节 申 请 到 的 授权 码 

spring.mail.default-encoding=UTF-8 

spring.mail .properties.mail.smtp.socketFactory.class=javax.net.ssl.SSLSocketFactory 
spring.mail.properties.mail.debug=true 


配置 完成 后 ， 接 下 来 在 resources/templates 目录 下 创建 邮件 模板 emailhtml， 代 码 如 下 : 











omDnammmwmn 


FF 
WNPO 


<!DOCTYPE html> 

<html lang="en" xmlns:th="http://www.thymeleaf .org"> 
<head> 

<meta charset="UTF-8"> 

<title>Title</title> 

</head> 

<body> 

<p> 你 好 ， 

<span th:text="$ {name}"></span> 同 学 ,欢迎 加 入 XXX 大 家 庭 ! 您 的 入 职 信息 如 下 : </p> 
<table border="1" cellspacing="0"> 

<tr> 

<td><strong style="color: #F00"> 工 号 </strong></td> 
<td th:text="${workID}"></td> 
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14 | </tr> 

15 | <tr> 

16 | <td><strong style="color: #F00"> 合 同期 限 </strong></td> 
17 | <td th:text="${contractTerm}+' 年 '"></td> 

18 | </tr> 
9 | -<tt> 
20 | <td><strong style="color: #00"> 合 同 起 始 日 期 </strong></tqd> 

21 | <td th:text="${#dates.format (beginContract, 'yyyy-MM-dd')}"></td> 
22 | </tr> 
23 | <tr> 
24 | <td><strong style="color: #00"> 合 同 截至 日 期 </strong></td> 

25 | <td th:text="${#dates.format (endContract, "YYYY-MM-dd') } "></td> 
26 | </tr> 
2 | xtr> 
28 | <td><strong style="color: #F00"> 所 属 部 门 </strong></td> 
29 | <td th:text="${departmentName}"></td> 

30 | </tr> 
31 | <tr> 
32 | <td><strong style="color: #F00"> 职 位 </strong></td> 
33 | <td th:text="${posName}"></td> 











34 | </tr> 

35 | </table> 

36 | <p> 

37 | <strong style="color: #F00; font-size: 24px;"> 
38 希望 在 未 来 的 日 子 里 ， 携 手 共 进 ! 

39 | </strong> 

40 | </p> 

41 | </body> 

42 | </html> 

43 





考虑 到 邮件 发 送 是 一 个 耗 时 操作 ， 因 此 在 子 线程 中 完成 邮件 发 送 操 作 ， 代 码 如 下 : 





和 public class EmailRunnable implements Runnable { 

2 private Employee employee; 

3 private JavaMailSender javaMailSender; 

4 private TemplateEngine templateEngine; 

入 

6 public EmailRunnable (Employee employee, 

区 JavaMailSender javaMailSender, 

8 TemplateEngine templateEngine) { 

9 this.employee = employee; 

10 this.javaMailSender = javaMailSender; 

this.templateEngine = templateEngine; 

12 ’ 

13 QOverride 

14 public void run() { 

15 try { 

16 MimeMessage message = javaMailSender.createMimeMessage(); 
Ey MimeMessageHelper helper = new MimeMessageHelper (message, true); 








18 helper. setTo (employee.getEmail ()); 
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19 helper.setFrom("1510161612@qq.com"); 

20 helper.setSubject ("XXX 集团 : 通知 ") ; 

2 Context ctx = new Context(); 

22 ctx.setVariable ("name", employee.getName()); 

23 ctx.setVariable ("workID", employee.getWorkID()); 

24 ctx.setVariable ("contractTerm", employee.getContractTerm()); 
25 ctx.setVariable ("beginContract", employee.getBeginContract ()); 
26 ctx.setVariable ("endContract", employee.getEndContract ()); 

| ctx.setVariable ("departmentName", employee.getDepartmentName()); 
28 ctx.setVariable ("posName", employee.getPosName()); 

29 String mail = templateEngine.process ("email.htm]l", ctx); 

30 helper.setText (mail, true); 

31 javaMailSender .send (message); 

32 } catch (MessagingException e) { 

33 System.out.println ("发 送 失败 "); 

34 } catch (javax.mail.MessagingException e) { 

35 e.printstackTrace (); 





最 后 ， 在 用 户 添加 成 功 后 ， 启 动 该 线程 发 送 邮 件 ， 代 码 如 下 : 











4 @RequestMapping (value = "/emp", method = RequestMethod.POST) 
2 | public RespBean addEmp (Employee employee) { 

3 if (empService.addEmp (employee) == 1) { 

4 List<Position> allPos = positionService.getAllPos (); 
和 for (Position allPo : allPos) { 

6 if (allPo.getId() == employee.getPosId()) { 

了 employee.setPosName (allPo.getName ()); 

8 } 

9 } 

10 executorService.execute (new EmailRunnable (employee, 
半生 javaMailSender, templateEngine)); 

12 return RespBean.ok(" 添 加 成 功 !") ; 

13 l 

14 return RespBean.error ("添加 失败 !"); 

后 3 





配置 完成 后 ， 重 启 后 端 项 目 ， 此 时 在 前 端 添加 用 户 ， 添 加 完成 后 ， 系 统 会 根据 所 添加 用 户 的 
邮箱 自动 发 送 一 封 欢迎 入 职 邮件 ， 如 图 16-19 所 示 。 
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XXX 集团 : 通知 
发 任 人 : 水 流 云 在 








件 人 ; 江南 一 点 才 





你 好 ， 令 狐 瓯 童鞋 ， 欢 迎 加 入 XXX 大 家 庭 ! 您 的 入 职 信息 如 下 : 






日 期 |2018-08-01 


E 
sa 
EE 

合同 截至 2021-08-01 
属 部 门 | 技术 部 








希望 在 未 来 的 日 子 里 ， 携 手 共 进 ! 
图 16-19 


完整 的 邮件 发 送 代码 可 以 在 GitHub 上 查看 ， 地 址 为 https://github.conylenve/vhr。 


16.8 ”员工 资料 导出 


将 员工 资料 导出 为 Excel 是 一 个 非常 常见 的 需求 , 后 端 提 供 导出 接口 , 前端 下 载 导出 数据 即 可 。 


16.8.1 后 端 接口 实现 


后 端 实现 主要 是 将 查询 到 的 员工 数据 集合 转 为 可 以 下 载 的 ResponseEntity<byte[]>， 代 码 如 下 : 











public static ResponseEntity<byte[]> exportEmp2Excel (List<Employee> emps) { 
2 HttpHeaders headers = null; 

3 ByteArrayOutputStream baos = null; 

4 try { 

5 //1 .创建 Excel 文档 

6 HSSFWorkbook workbook = new HSSFWorkbook(); 

囊 //2 .创建 文档 摘要 

8 Workbook.createInformationProperties () 7 

9 //3 .获取 文档 信息 ， 并 配置 

10 DocumentSummaryInformation dsi = 

站 workbook.getDocumentSummaryInformation(); 

12 /113.1 文档 类 别 

1 dsi.setCategory ("员工 信息 "); 

14 //3.2 设置 文档 管理 员 

妨 dsi .setManager (" 江 南 一 点 雨 ") ; 

16 //3.3 设置 组 织 机 构 

7 dsi .setCompany("XXX 集团 ") ; 

18 //4. 获 取 摘 要 信息 并 配置 

19 SummaryInformation si = workbook.getSummaryInformation(); 
20 //4.1 设置 文档 主题 
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35 
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si.setSubject ("员工 信息 表 ") ; 

/14.2. 设 置 文档 标题 

si.setTitle ("员工 信息 "); 

//4.3 设置 文档 作者 

si.setAuthor ("XXX 集团 ") ; 

//14.4 设置 文档 备注 

si.setComments ("备注 信息 暂 无 ") ; 

// 创 建 Excel 表单 

HSSFSheet sheet = workbook.createSheet ("XXX 集团 员工 信息 表 ") ; 

// 创 建 日 期 显示 格式 

HSSFCellStyle dateCellStyle = workbook.createCellStyle(); 
dateCellSstyle.setDataFormat (HSSFDataFormat .getBuiltinFormat ("m/d/yy")); 
// 创 建 标题 的 显示 样式 

HSSFCellStyle headerStyle = workbook.createCellStyle(); 
headerStyle.setFillForegroundColor (IndexedColors.YELLOW. index); 
headerStyle.setFillPattern (FillPatternType.SOLID FOREGROUND); 

// 定 义 列 的 宽度 
sheet .setColumnWidth(0, 5 * 256); 
sheet .setColumnWidth(1，12 * 256); 
sheet.setColumnWidth (18, 20 * 256); 
sheet.setColumnWidth (19, 12 * 256); 
sheet.setColumnWidth (20, 8 * 256); 
sheet.setColumnWidth (21, 25 * 256); 
sheet.setColumnWidth (22, 14 * 256); 
sheet .setColumnWidth (23, 12 * 256); 
sheet.setColumnWidth (24, 12 * 256); 
//5. 设 置 表 头 
HSSFRow headerRow = sheet.createRow(0) 
HSSFCell cell0 = headerRow.createCel1(0) 
cel10.setCellValue (" 编 号 ") ; 
cell0.setCellStyle (headerStyle) 

HSSFCell celll = headerRow.createCell (1); 
celll.setCellValue ("姓名 "); 
celll.setCellStyle (headerStyle); 

HSSFCell cel118 = headerRow.createCell (18); 
cel118.setCellValue ("毕业 院 校 ") ; 
celll8.setCellStyle (headerStyle); 

HSSFCell cell19 = headerRow.createCell (19); 
cel119.setCellValue ("入 职 日 期 ") ; 
cel119.setCel1Style (headerStyle); 

HSSFCell cell20 = headerRow.createCell (20); 
cel120 .setCellValue ("在 职 状态 ") ; 
cell20.setCellStyle (headerStyle); 

HSSFCell cell21 = headerRow.createCell (21); 
cel121.setCellValue ("邮箱 ") ; 
cel121.setCel1Style (headerStyle); 

HSSFCell cell22 = headerRow.createCell (22); 
cel122 .setCellValue ("合同 期 限 (年) ") ; 
cell22.setCellStyle (headerStyle); 

HSSFCell cell23 = headerRow.createCell (23); 
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i cel123.setCellValue ("合同 起 始 日 期 ") ; 

了 cell23.setCellStyle (headerStyle); 

73 HSSFCell cell24 = headerRow.createCell (24); 

74 cel124.setCellValue ("合同 终止 日 期 ") ; 

5 cell24.setCellStyle (headerStyle); 

76 /16. 装 数据 

77 for (int i = 0; i < emps.size(); i++) { 

78 HSSFRow row = sheet.createRow (i + 1); 

79 Employee emp = emps.get (i); 

80 row.createCell (0) .setCellValue (emp.getId()); 

81 row.createCell (1) .setCellValue (emp.getName ()); 

82 row.createCell (18) .setCellValue (emp.getSchool ()); 

83 HSSFCell beginDateCell = row.createCell (19); 

84 beginDateCell.setCellValue (emp.getBeginDate()); 

85 beginDateCell.setCellStyle (dateCellStyle); 

86 row.createCell (20) .setCellValue (emp .getWorkState () ) 7 

87 row.createCell (21) .setCellValue (emp.getEmail ()); 

88 row.createCell (22) .setCellValue (emp.getContractTerm() ) 
89 HSSFCell beginContractCell = row.createCell (23); 

90 beginContractCell.setCellValue (emp.getBeginContract ()); 
91 beginContractCell.setCellStyle (dateCellStyle); 

92 HSSFCell endContractCell = row.createCell (24); 

93 endContractCel1.setCellValue (emp.getEndContract ()); 

94 endContractCell .setCellStyle (dateCellStyle); 

95 } 

96 headers = new HttpHeaders(); 

97 headers.setContentDispositionFormData ("attachment", 

98 new String ("员工 表 .xls".getBytes ("UTF-8")，"iso-8859-1")); 
99 headers.setContentType (MediaType.APPLICATION OCTET STREAM); 
100 baos = new ByteArrayOutputStream(); 

101 workbook.write (baos); 

102 } catch (IOException e) { 

103 e.pIintStackTrace (); 

104 } 

105 return new ResponseEntity<byte[]> (baos.toByteArray (), headers, 


106 | HttpStatus.CREATED); 

} 

代码 解释 : 

e 首先 构建 一 个 HSSFWorkbook 进行 Excel 基本 信息 配置 ， 如 文档 信息 、 摘 要 信息 等 。 

@ 第 37-75 行 配置 列 的 宽度 并 设置 表 头 。 由 于 配置 方式 重复 ， 因 此 这 里 省 略 了 第 2~17 列 的 配 
置 ， 完 整 配置 可 在 GitHub 上 下 载 。 

@ 第 77-94 行 表示 遍历 emps 集合 ， 将 数据 填充 到 Excel 中 。 

@ 第 97、98 行 表示 设置 下 载 请 求 的 文件 和 名、 编码 等 信息 。 


配置 完成 后 ， 在 下 载 请 求 接口 中 调用 该 方法 即 可 ， 代 码 如 下 : 


1 | eaRequestMapping(value = "/exportEmp", method = RequestMethod.GET) 
2 | public ResponseEntity<byte[]> exportEmp () { 
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3 return PoiUtils.exportEmp2Excel (empService.getAllEmployees ()); 











16.8.2 前端 实现 


前 端的 实现 比较 简单 ， 当 用 户 单 击 “ 导 出 ”按钮 时 ， 执 行 如 下 代码 发 起 请 求 ， 下 载 文 件 : 


| 1 [ window.open (yemployee/basic/exportEmp"， " parent"); | 


按钮 时 ， 会 自动 弹出 文件 保存 窗口 ， 将 文件 保存 即 可 。 下 载 后 的 Excel 如 图 16-20 所 示 。 

































































男 Ed 1 
2 ooo0002 妇 。 1989/2121238193902011234 已 计 5785556693 因 术 还 外 
3 bt 洁 0000003 要 1993M4 后 10122199303011455 林寺 5598857795 到 术 研 工 程 厅 
4 更 F 计 0000004 号 193011 硬 1012219300103155 己 寺 612347795 到 四 运 兴工 程 而 
5 遇 on00005 男 1991/2 所 外 10122199102056652 “已 并 4785556936 中 而 工程 所 “去 堆 工程 
5 云 量 Wo000005 女 “1992/V510122199301054799 已 时 53644442252 绩 生 西 安 条 城区。 运 闪 避 再 吧 程 厅 “ 运 准 程 而 
7 IE 明 “0000007 勇 。”99Y1111 和 1012219331111124， 已 时 3544441234 “三 东 宫 广 州 市 天 河 区 市场 可 中 改称 阿 “研发 工程 了 
3 张 节 明和 0000008 办 1991G/110144199102014569 已 噶 玩 直 部 中 碟 工 程 阿 “ 研 必 工程 
9 可 Yoooooo9 画 19921/1 和 10144199207017895 已 后 ji 初 到 工程 本 运 堆 工程 厅 
1 张 洁 ooooo1 女 。。 1990r09920177199010093652 未 二 3695557742 ie 商工 程 柯 。 运 兴 工程 人 
11 自 导 后 2 jb0000011 办 19907V1 上 10122193001011256 己 寺 8565558897 扫 术 区 Ee 按 术 总 点 
12 Mg2 0000012 女 1986/2/1 21286199602011234 “已 本 O785556693 用 运 覃 总 点 
人 as2 V0000013 对 1993RM 1012219930041&55 未 时 3696897795 过 研发 [ 程 后 
仁 砚 FF2 。 Vo000014 胃 1990V310122199001031455“ 己 只 Tis612347795 肥 扩 运 间 工程 厅 
15 2 Wooooo15 田 1991/25 外 10122199102058952 “已 后 785559935 中 级 工程 隐 。。 到 法 工程 同 
15 E22 ooo0015 妆 1993/V5 第 10122199301054739 “已 后 5644442252 商 级 工程 阿 。 运 堆 工程 厅 
17 到 6E 史 2 90000017 于 199371VI110122199311T11234 已 后 Tiss4441234 中 于 工程 阿 。 研发 工程 
翰 王 训 oooc018 甸 1991/2/1 包 10144199102014569 己 寺 68979994478 中 时 工 季 历 。 研发 工友 
休 诈 本 2 V0000019 男 1992/7/1 和 10144199207017695 “已 997741 初 员工 程 所 “ 运 淮 开 程 
20 福 2 V0000020 女 “1990/109920177199010093652 未 二 9655557742 高 中 T 程 所 运 准 T 程 卫 
21 白 EB 罗 3 。 ho000021 胃 1990V110122199001011255 已 叶 8665558897 于 本 呈 
22 3 “Woo00022 女 19892/1%21288193902011234 已 后 a796556693 网校 还 ge 上 
24 mW0000021 对 1990713 后 10122199001031455 已 后 5612347795 bry 运 夫 工程 机 
ionoo25 加 199125 60122199102058952 已 夫 4785550935 


经 过 如 上 配置 后 ， 员 工 数据 导出 功能 就 实现 了 ， 完 整 代码 读者 可 以 参考 
https://github.com/lenve/vhr。 


16.9 ”员工 资料 导入 


既然 有 员工 资料 导出 需求 ， 当 然 也 就 有 导入 需求 。 对 前 端 而 言 ， 员 工资 料 导入 就 是 文件 上 传 ， 
对 后 端 而 言 ， 则 是 获取 上 传 的 文件 进行 解析 ， 并 把 解析 出 来 的 数据 保存 到 数据 库 中 。 


16.9.1 后 端 接口 实现 


后 端 主要 是 获取 前 端 上 传 文件 的 流 ， 然 后 进行 解析 ， 代 码 如 下 : 


public static List<Employee> importEmp2List (MultipartFile file, 

List<Nation> allNations, 
List<PoliticsStatus> allPolitics, 
List<Department> allDeps, 
List<Position> allPos, 
List<JobLevel> allJobLevels) { 

List<Employee> emps = new ArrayList<>(); 

try { 





1 
2 
3 
4 
5 
6 
7 
8 
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3 HSSFWorkbook workbook = 

10 new HSSFWorkbook (new POIFSFileSystem(file.getInputSstream())); 
11 int numberOfSheets = workbook.getNumberOfSheets (); 

12 for (int i = 0; i < numberOfSheets; i++) { 

13 HSSFSheet sheet = workbook.getSheetAt (i); 

14 int physicalNumberOfRows = sheet .getPhysicalNumberOfRows (); 
5 Employee employee; 

16 for (int j = 0; j < physicalNumberOfRows; j++) { 

17 if (j} = 0) { 

18 continue; // 标 题 行 

19 } 

20 HSSFRow row = sheet.getRow(j); 

21 if (row == null) { 

2 continue; // 没 数据 

23 } 

24 int physicalNumberOfCells = row.getPhysicalNumberOfCells(); 
25 employee = new Employee(); 

26 for (int k = 0; k < physicalNumberOfCells; k++) { 

27 HSSFCell] cell = row.getCell (k); 

28 switch (cell.getCellTypeEnum()) { 

29 case STRING: { 

30 String cellValue = cell.getStringCellValue(); 

31 if (cellValue == null) { 

32 cellValue = ""; 

33 } 

34 switch (k) { 

35 case 1: 

36 employee. setName (cellValue); 

37 break; 

38 case 2: 

39 employee.setWorkID (cellValue); 

40 break; 

41 case 3: 

42 employee.setGender (cellValue); 

43 break; 

44 case 5: 

45 employee.setIdCard (cellValue); 

46 break; 

47 case 6: 

48 employee.setWedlock (cellValue); 

49 break; 

50 ease 7: 

51 int nationIndex = allNations.indexOf (new Nation (cellValue)); 
52 employee.setNationId(allNations.get (nationIndex) .getId()); 
53 break; 

54 case 8: 

55 employee.setNativePlace (cellValue); 

56 break; 

57 case 9: 

58 int psIndex = allPolitics.indexOf (new PoliticsStatus (cellValue)); 
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75 
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90 
91 
3 
93 
94 
E22 
96 
97 
98 
39 
100 
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108 


employee.setPoliticId(allPolitics.get (psIndex) .getId()); 
break; 

case 10: 
employee.setPhone (cellValue); 
break; 

case 11: 
employee.setAddress (cellValue); 
break; 

case 12: 
int depIndex = allDeps.indexOf (new Department (cellValue)); 
employee.setDepartmentId(allDeps .get (depIndex) .getId()); 
break; 

case 13: 
int jlIndex = allJobLevels.indexOf (new JobLevel (cellValue)); 
employee.setJobLevelId (allJobLevels.get (jlIndex) .getId()); 
break; 

case 14: 
int posIndex = allPos.indexOf (new Position(cellValue)); 
employee.setPosId(allPos.get (posIndex) .getId()); 
break; 

case 15: 
employee. setEngageForm(cellValue); 
break; 

case 16: 
employee. setTiptopDegree (cellValue); 
break; 

case 17: 
employee.setSpecialty (cellValue); 
break; 

case 18: 
employee.setSchool (cellValue); 
break; 

case 19: 

case 20: 
employee. setWorkState (cellValue); 
break; 

case 21: 
employee.setEmail (cellValue); 
break; 





} 
break; 
default: { 
switch (k) { 
case 4: 
employee.setBirthday (cell .getDateCellValue ()); 
break; 
Case 19: 
employee.setBeginDate (cell.getDateCellValue ()); 
break; 
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109 case 22: 
110 employee.setContractTerm(cell .getNumericCellValue ()); 
111 break; 
112 case 23: 
Ti employee.setBeginContract (cell.getDateCellValue ()); 
114 break; 
115 case 24: 
116 employee.setEndContract (cell .getDateCellValue ()); 
117 break; 
118 } 
119 
120 break; 
lal 
122 
123 emps .add (employee); 
124 
125 
126 catch (IOException e) { 
127 e.printstackTrace (); 
128 
129 return emps; 











代码 解释 : 


首先 根据 上 传 文件 的 流 获取 一 个 HSSFWorkbook 对 象 ， 然 后 获取 workbook 中 表单 的 个 数 ， 
进行 遍历 。 

对 于 每 一 个 表单 ， 首 先 获取 行 数 ， 然 后 进行 遍历 ， 第 一 行 是 标题 行 ， 跳 过 ， 如 果 该 行 没有 数 
据 也 跳 过 ， 如 果 该 行 数据 正常 ， 就 获取 该 行 的 单元 格 个 数 进行 遍历 。 

本 案例 中 ， 单 元 格 的 格式 主要 分 为 三 种 ， 即 日 期 、 数 字 以 及 普通 文本 ， 因 此 在 不 同 的 switch 
分 支 中 进行 处 理 。 

最 后 将 遍历 得 到 的 员工 数据 集合 返回 。 


在 数据 导入 接口 中 调用 importEmp2List 方法 ， 获 取 员工 数据 集合 后 ， 插 入 数据 库 中 即 可 ， 代 
码 如 下 : 





1 
2 
3 
4 
5 
6 
7 
8 
9 


10 
11 





@RequestMapping (value = "/importEmp", method = RequestMethod.POST) 
public RespBean importEmp (MultipartFile file) { 

List<Employee> emps = PoiUtils.importEmp2List (file, 
empService.getAllNations(), empService.getAllPolitics(), 
departmentService.getAllDeps(), positionService.getAllPos(), 
jobLevelService.getAllJobLevels()); 

if (empService.addEmps (emps) == emps.size()) { 

return RespBean.ok(" 导 入 成 功 !"); 
} 
return RespBean.error (" 导 入 失败 !") 7 





} 
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16.9.2 前端 实现 


前 端 主要 是 一 个 Excel 表格 的 上 传 ， 这 里 直接 采用 Element 的 文件 上 传 控件 ， 代 码 如 下 : 








Fowmawmmwmn 
Po 


上 
DL 





记 户 户 
AMR 


<el-upload 
:show-file-list="false" 
accept="application/vnd.ms-excel" 
action="/employee/basic/importEmp" 
:on-success="fileUploadSuccess" 
:on-error="fileUploadError" 
:disabled="fileUploadBtnText==' 正 在 导入 '" 
:before-upload="beforeFileUpload" 
style="display: inline"> 

<el-button size="mini" type="success" 
:loading="fileUploadBtnText==' 正 在 导入 '"> 

<i class="fa fa-lg fa-level-up"></i> 
{{fileUploadBtnText}} 

</el-button> 








</el-upload> 





oamm 必 wm 





代码 解释 : 


accept 表示 接收 的 上 传 文件 类 型 。 

action 表示 上 传 接口 。 

:On-success 表示 上 传 成 功 时 的 回调 。 

:on-error 表示 上 传 失败 时 的 回调 。 

:disabled 表示 当 fileUploadBtnText 属性 的 值 为 “正在 导入 ”时 禁用 上 传 控件 。 这 个 配置 主要 
考虑 到 上 传 是 一 个 耗 时 操作 ， 在 一 个 文件 上 传 的 过 程 中 ， 其 他 文件 暂时 不 能 上 传 。 

@ :before-upload 表示 文件 上 传 前 的 回调 。 

eel-button 中 的 :loading="fileUploadBtnText 一 正在 导入 "表示 当 fileUploadBtnText 的 文本 为 “ 正 
在 导入 ”时 ， 显 示 一 个 Loading 加 载 


相关 回调 方法 如 下 : 


fileUploadSuccess (response, file, fileList){ 
if (response) { 
this. $message ({type: response.status, message: response.msg}); 
} 
this.loadEmps (); 
this.fileUploadBtnText = ' 导 入 数据 '; 
}, 
fileUploadError (err, file, fileList){ 
this.$message ({type: 'error', message: "导入 失败 !"}); 
this.fileUploadBtnText = ' 导 入 数据 '; 
}, 
beforeFileUpload (file){ 
this.fileUploadBtnText = ' 正 在 导入 '; 
} 
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代码 解释 : 

e ”在 文件 上 传 之 前 ， 首 先 设置 fleUploadBtnText 的 文本 为 “正在 导入 ”， 这 样 上 传 按钮 上 的 文本 
就 会 变 为 “正在 导入 ”, 同时 上 传 按钮 的 状态 变 为 禁用 ,并 且 在 上 传 按钮 上 多 了 一 个 Loading。 

@ ”在 上 传 成 功 时 ， 给 用 户 以 提示 ， 然 后 重新 加 载 员 工 数据 ， 并 将 fleUploadBtnText 的 文本 设置 
为 “导入 数据 ”。 

”上传 出 错时 ， 给 用 户 以 提示 ， 同 时 将 fleUploadBtnText 的 文本 设置 为 “导入 数据 ”。 


所 有 配置 完成 后 ， 单 击 “ 导 入 数据 ”， 选 择 16.8 节 导 出 的 用 户 数 据 进行 导入 ， 如 图 16-21 所 











电子 邮件 操作 


laowang@qq.com 篇 鼻 开除 | 


图 16-21 





16.10 在线 聊天 


在 线 聊天 是 一 个 为 了 方便 HR 进行 快速 沟通 提高 工作 效率 而 开发 的 功能 ,考虑 到 一 个 公司 中 的 
HR 并 不 多 ， 并 发 量 不 大 ， 因 此 这 里 直接 使 用 最 基本 的 WebSocket 来 完成 该 功能 。 


16.10.1 ”后 端 接口 实现 


要 使 用 WebSocket， 首 先 引 入 WebSocket 依赖 : 





<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-websocket</artifactId> 


必 ww 


</dependency> 


依赖 添加 成 功 后 ， 接 下 来 配置 WebSocket 配置 类 ， 代 码 如 下 : 


@Configuration 

@EnableWebSocketMessageBroker 

public class WebSocketConfig extends AbstractWebSocketMessageBrokerConfigurer { 
QOverride 
public void registerStompEndpoints (StompEndpointRegistry stompEndpointRegistry) 








stompEndpointRegistry.addEndpoint ("/ws/endpointChat") .withSockJS () 








oODP 
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9 
10 QOverride 
11 public void configureMessageBroker (MessageBrokerRegistry registry) { 
12 registry.enableSimpleBroker ("/queue", "/topic"); 
13 } 
} 

然后 创建 消息 转发 Controller， 代 码 如 下 : 
1 @Configuration 
2 @EnableWebSocketMessageBroker 
3 public class WebSocketConfig extends AbstractWebSocketMessageBrokerConfigurer { 
4 QOverride 
5 public void registerStompEndpoints (StompEndpointRegistry stompEndpointRegistry) 
6 和 
了 stompEndpointRegistry.addEndpoint ("/ws/endpointChat") .withSockJS () 
8 } 
和 
10 QOverride 
二 public void configureMessageBroker (MessageBrokerRegistry registry) { 
12 registry.enableSimpleBroker ("/queue", "/topic"); 
13 } 











配置 完成 后 ， 重 启 后 端 项 目 ， 然 后 开始 配置 前 端 。 





16.10.2 ”前 端 实现 


聊天 功能 写 在 FriendChat.vue 组 件 中 ， 但 是 用 户 登 录 成 功 后 ， 首 先 加载 的 是 Home.vue 页 面 ， 
在 Home 页 面 的 右上 角 有 一 个 通知 的 图 标 ， 如 果 有 最 新 的 通知 ， 这 里 会 显示 一 个 红 点 ， 如 图 16-22 
所 示 。 








图 16-22 





因此 , 虽然 聊天 是 在 FriendChat.vue 页 面 进行 的 , 但 是 WebSocket 连接 却 需 要 登录 成 功 后 才 建 








立 ， 这 里 选择 在 store 中 建立 WebSocket 请 求 ， 代 码 如 下 : 
1 import Vue from 'vue' 
2 import Vuex from 'vuex" 
3 import '../lib/sockjs' 
4 import '../lib/stomp" 
和 
6 Vue.use (Vuex) 























332 | Spring Boot+Vue 全 栈 开 发 实战 

省 

8 export default new Vuex.Store({ 

9 state: { 

10 routes: [], 

11 msgList: [], 

12 isDotMap: new Map(), 

3 currentFriend: {}, 

14 stomp: Stomp .over (new SockJS("/ws/endpointChat")), 
15 nfDot: false 

16 }, 

LT mutations: { 

18 toggleNFDot (state, newValue){ 

19 state.nfDot = newValue; 

20 6 

21 updateMsgList (state, newMsgList){ 

22 state.msgList = newMsgList; 

23 

24 updateCurrentFriend (state, newFriend){ 

25 state.currentFriend = newFriend; 

26 和 

2 addValue2DotMap (state, key){ 

28 state.isDotMap.set (key，" 您 有 未 读 消息 ") 

29 7 

30 removeValueDotMap (state, key){ 

31 state.isDotMap.delete (key); 

32 

33 }, 

34 actions: { 

35 connect (Context) { 

36 context.state.stomp = Stomp.over (new SockJS("/ws/endpointChat")); 
37 context.state.stomp.connect ({}, frame=> { 

38 context .state.stomp.subscribe("/user/queue/chat", message=> { 
39 // 接 收 在 线 聊天 消息 

40 Dy 

41 context. state.stomp.subscribe("/topic/nf", message=> { 
42 // 接 收 系统 通知 

43 1); 

44 }, failedMsg=> { 





an 必 wm 





定义 好 之 后 ， 在 初始 化 菜单 数据 的 地 方 调用 connect 方法 建立 WebSocket 连接 ， 代 码 如 下 : 


export const initMenu = (router, store)=> { 
if (store.state.routes.length > 0) { 
return; 


} 
getRequest ("/config/sysmenu") .then (resp=> { 
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6 if (resp && resp.status == 200) { 

二 var fmtRoutes = formatRoutes (resp.data); 
8 router .addRoutes (fmtRoutes); 

9 store.commit ('initMenu', fmtRoutes); 

10 store.dispatch('connect'); 

11 } 

12 ) 

13 1 











通过 store.dispatch('connect"); 调 用 connect 方法 。 
这 里 配置 完成 后 , 重新 登录 , 在 Chrome 控制 台 可 以 看 到 WebSocket 连接 已 经 成 功 建立 起 来 了 ， 
如 图 16-23 所 示 。 


Opening Web Socket... 





Web Socket Opened... 
>>> CONNECT 
accept-version:1.1,1.0 
heart-beat;110000,19869 





<<< CONNECTED stomp.ijs?195a:145 
version:1.1 

heart-beat:0,0 

user-name:admin 


connected to server undefined 
>>> SUBSCRIBE 

id:sub-@ 

destination: /user/queue/chat 





>>> SUBSCRIBE stomp.js21953:145 
id:sub-1 
destination: /topic/nf 








图 16-23 


最 后 ， 在 FriendChat.vue 中 通过 如 下 方式 发 送 一 条 消息 : 


this.$store.state.stomp.send("/ws/chat", {}, this.msg + ";" + 


this.currentFriend.username); 





另外 ， 浏 览 器 在 收 到 消息 之 后 ， 是 将 消息 保存 在 store 中 的 ， 这 样 一 旦 收 到 消息 ，FriendChat 
页 面 的 聊天 数据 就 会 自动 更 新 ， 并且， 当 有 新 消息 到 达 时 ， 即 使 用 户 不 在 FriendChat 页 面 ， 也 能 及 
时 收 到 通知 〈 主 页 右上 角 的 通知 图 标 会 显示 小 红 点 ) 。 

聊天 效果 如 图 16-24、 图 16-25 所 示 。 
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FE ED er et 
和 三 (em ee ] et [本 二 & 
EE EE 
图 16-24 图 16-25 
这 里 由 于 前 端 页 面 代码 量 庞 大 ， 因 此 只 贴 出 部 分 关键 步骤 的 代码 ， 完 整 代码 读者 可 以 在 


https://github.com/lenve/vhr 下 载 。 


这 里 有 两 个 订阅 ，“/user/queue/chat” 是 用 来 做 在 线 聊天 的 ，“/topic/nf” 则 是 为 了 接收 系统 
通知 。 





16.11 “前端 项 目 打包 


当前 端 项 目 开发 完成 后 ， 执 行 如 下 命令 对 项 目 进 行 打包 : 
执行 结果 如 图 16-26 所 示 。 





图 16-26 











打包 完成 后 ， 在 当前 工作 目录 下 生成 一 个 dist 文件 夹 ， 如 图 16-27 所 示 。 将 里 边 的 index.html 
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和 static 目录 复制 到 Spring Boot 项 目的 static 目录 下 ， 如 图 16-28 所 示 。 















‘idea 
mvn 
src 
oot . 
v main 
> Mljava 
babel v eresources 
而 .babelrc 
v Hstatic 
前 .editorconfig 
> static 











着 .gitignore 
总 :postcssrcjs 品 indexhtml 
起 index.html > Bltemplates 
而 packagejson 而 application.properties 
大 package-lockjson 大 mybatis-confjg.xml 
生 README.md 号 vhrsql 
图 16-27 图 16-28 


接 下 来 ， 启 动 后 端 项 目 ， 直 接 在 浏览 器 中 输入 http://localhost:8082/index.html 就 可 以 看 到 登录 
页 面 ， 如 图 16-29 所 示 。 此 时 就 可 以 将 该 Spring Boot 项 目 直接 打包 发 布 〈 参 见 第 15 章 ) 。 





7 < 
€ 3 © OO locahostarg2/indexhimie 立 
系统 登录 
® 记 人 2 








16.12 小 结 








本 章 向 读者 介绍 了 一 个 微 人 事项 目 ， 主 要 从 登录 模块 、 动 态 加 载 用 户 菜单 、 员 工资 料 模块 、 
邮件 发 送 模块 、Excel 导入 导出 模块 、 在 线 聊 天 模块 以 及 编译 打包 几 个 方面 介绍 。 由 于 原 项 目 代码 
量 庞大 ， 本 章 主 要 选取 一 些 关键 步 又 进行 介绍 ， 完 整 代码 读者 可 以 在 GitHub 上 下 载 ， 下 载 地 址 为 
https://github.com/lenve/vhr。 


